Skip to content
quick start

Claude Desktop

One install, one JSON block, one restart. Argand becomes a search tool inside Claude.

1. Install argand-mcp

The MCP stdio binary lives in the Argand source repo on Forgejo. Install with cargo:

cargo install --git ssh://git@git.argand.org/nicweyand/argand.git argand-mcp

Requires a working Rust toolchain (rustup default stable). The binary lands in ~/.cargo/bin/argand-mcp; make sure that's on your PATH.

2. Edit your Claude Desktop config

Open the config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Paste this in (or merge into your existing config):

claude_desktop_config.json json
{
  "mcpServers": {
    "argand": {
      "command": "argand-mcp",
      "args": []
    }
  }
}

3. Restart Claude Desktop

Fully quit and reopen the app (the MCP server list is read at startup). Argand should now appear under the MCP tools indicator. Try a query like "search Argand for the rust-lang async runtime guide" and you'll see real results with URLs, snippets, and supply-chain risk signals on registry-scoped hits.

Optional: point at a self-hosted Argand

Set ARGAND_API_BASE to your own deployment. Default is http://localhost:8080 (the API gateway dev port). For argand.org production, leave it unset — the binary will auto-detect.

claude_desktop_config.json json
{
  "mcpServers": {
    "argand": {
      "command": "argand-mcp",
      "args": [],
      "env": {
        "ARGAND_API_BASE": "https://argand.example.org"
      }
    }
  }
}

What you just unlocked

  • search — web, programming, academic, news verticals
  • fetch_url — Readability-extracted page text via the polite-crawler proxy
  • cite — verifiable citation block (archive timestamp + content hash)
  • package_lookup — strict-existence registry lookup with risk signals (refuses to soft-match hallucinated package names)

Full tool surface details: MCP stdio reference.