Home / Integrations / MCP

PlasmidDB MCP Server v0.1.0

A Model Context Protocol server that exposes PlasmidDB's REST API as tools. Works in Claude Desktop, Kimi CLI, Cherry Studio, and any other MCP-aware client. Ships as a single Python wheel — one install, two env vars, done.

Download wheel
plasmiddb_mcp-0.1.0-py3-none-any.whl

Get an API token from Sign in, then Profile → API tokens → New token. The MCP server sends it as Authorization: Token …. Read-only for regular tokens; create / update / delete tools return HTTP 403 unless the token owner is superuser or staff.

Install

Needs Python 3.10+ and pip. The wheel bundles one dep (httpx) plus the official mcp SDK.

pip install http://118.25.141.96/oss/mtclab/plasmiddb/integrations/20260421/plasmiddb_mcp-0.1.0-py3-none-any.whl
# or download first, then:
pip install plasmiddb_mcp-0.1.0-py3-none-any.whl

Configure your MCP client

Kimi CLI / Claude Desktop

JSON config

Add to ~/.kimi/mcp.json (Kimi CLI) or claude_desktop_config.json (Claude Desktop):

{
  "mcpServers": {
    "plasmiddb": {
      "command": "plasmiddb-mcp",
      "env": {
        "PLASMIDDB_TOKEN": "<your-token>",
        "PLASMIDDB_BASE_URL": "https://addgene.mtc-lab.cn"
      }
    }
  }
}

Replace <your-token> with the value copied from your profile. Restart the client; the plasmiddb tools appear in the tool picker.

Cherry Studio

stdio

Open Settings → MCP Servers → Add.
Fill in:

Name:    plasmiddb
Type:    stdio
Command: plasmiddb-mcp

Env:
  PLASMIDDB_TOKEN      = <your-token>
  PLASMIDDB_BASE_URL   = https://addgene.mtc-lab.cn

Save and enable. The tools show up in the assistant's context menu.

Tools exposed

Tool	What it does	Required args
`plasmid_list`	Search & paginate plasmids. Filters: `species`, `expression_type`, `depositor`, `topology`, `search`, `ordering`, `page`.	—
`plasmid_get`	Fetch one plasmid.	`plasmid_id`
`feature_list`	Search & paginate features. Filters: `type`, `category`, `gene`, plus `search`/`ordering`.	—
`feature_get`	Fetch one feature (incl. representative DNA & protein).	`feature_id`
`variant_list`	List physical occurrences of a feature on specific plasmids.	—
`variant_get`	Fetch one variant with its per-plasmid sequence.	`variant_id`
Superuser / staff only — below return HTTP 403 otherwise.
`plasmid_create` / `feature_create` / `variant_create`	Create a new record.	`fields`
`plasmid_update` / `feature_update` / `variant_update`	Partial-update (PATCH).	`<id>`, `fields`
`plasmid_delete` / `feature_delete` / `variant_delete`	Delete a record.	`<id>`

Troubleshooting

PLASMIDDB_TOKEN is not set — the MCP client didn't forward the env. Double-check the env block in the MCP config.
HTTP 401 — token is revoked / expired / typo'd. Regenerate in your profile.
HTTP 403 on a create / update / delete — your token owner isn't superuser or staff; that's expected, ask an admin.
command not found: plasmiddb-mcp — the wheel isn't on the PATH your MCP client uses. Either put pip show -f plasmiddb-mcp's script dir on PATH, or use the absolute path to plasmiddb-mcp in the command field.