Skip to content

Claude Desktop (MCP) Setup

BioMCP can run as an MCP server over stdio. If your Claude Desktop build offers the Anthropic Directory, install BioMCP there first. Use the JSON config below when you want a local/manual setup.

Add BioMCP server config

Use biomcp serve as the MCP command:

{
  "mcpServers": {
    "biomcp": {
      "command": "biomcp",
      "args": ["serve"]
    }
  }
}

If biomcp is not on your PATH, use the absolute path to the binary (e.g. ~/.local/bin/biomcp).

Validate before connecting Claude

biomcp --version
biomcp health --apis-only

Verify MCP-level behavior

When connected, clients should discover:

  • one tool: biomcp
  • one help resource (biomcp://help)
  • one markdown resource per embedded BioMCP worked example (biomcp://skill/<slug>)

Resource discovery gives agent clients both the overview entry point and the worked-example catalog before execution.

Operational tips

  • Keep API keys in the client launch environment.
  • Restart Claude Desktop after config changes.
  • Prefer stable absolute paths in managed environments.