
phageagent
io.github.yiyabo/phageagent
PhageAgent MCP: PhageScope phage database and analysis tasks. Sign up at phageagent.deepomics.org.
Documentation
PhageAgent MCP — client packages and directory listings
Source of the public repo https://github.com/yiyabo/phageagent-mcp (this folder becomes its root).
Remote MCP server: https://phageagent.deepomics.org/mcp (Streamable HTTP,
bearer token gpsk_...). Server code and access settings:
app/services/phagescope_mcp/README.md.
Every self-issued token gets all 17 tools: 11 read-only data tools
(catalog_overview, search_phages, cohort_report, aggregate_phages,
get_phage, get_sequence, search_proteins, search_families,
family_members, query_features, get_structures) and 6 analysis-task tools
that hand a request to PhageAgent and return its results. Data reads
are capped at 2 GB per token per day; analysis tasks have no quota during the
test phase.
Access
Anyone can use it: sign up at https://phageagent.deepomics.org, then create a token yourself (see "Get a token" below). Questions: xxwang5587@gmail.com.
Layout
| Path | For |
|---|---|
.claude-plugin/marketplace.json, claude/phageagent/ | Claude Code plugin marketplace; the token is a sensitive userConfig option |
.agents/plugins/marketplace.json, codex/phageagent/ | Codex plugin marketplace; the token comes from PHAGEAGENT_MCP_TOKEN |
hermes/manifest.yaml | Draft entry for Hermes' curated catalog (optional-mcps/phageagent/manifest.yaml in NousResearch/hermes-agent) |
registry/server.json | Official MCP Registry entry (io.github.yiyabo/phageagent) |
PRIVACY.md | Privacy policy |
Install
Sign up or sign in at https://phageagent.deepomics.org and POST /phagescope-mcp/tokens {"name": "<client>"}.
Claude Code:
claude plugin marketplace add yiyabo/phageagent-mcp
claude plugin install phageagent@phageagent
claude plugin configure phageagent@phageagent # prompts for the token
Codex:
codex plugin marketplace add yiyabo/phageagent-mcp
codex plugin add phageagent@phageagent
export PHAGEAGENT_MCP_TOKEN=gpsk_...
Hermes (until the catalog entry is accepted):
hermes mcp add phageagent --url https://phageagent.deepomics.org/mcp \
--header "Authorization: Bearer $PHAGEAGENT_MCP_TOKEN"
Checks
claude plugin validate .andclaude plugin validate ./claude/phageagentcodex plugin marketplace add "$PWD" && codex plugin add phageagent@phageagent && codex mcp listHERMES_OPTIONAL_MCPS=<dir containing phageagent/manifest.yaml> hermes mcp catalogregistry/server.jsonagainsthttps://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
No installation packages available.