AlphaFold Sovereign MCP — Claude Code MCP server: setup
AlphaFold Sovereign MCP is a Claude Code MCP server for querying AlphaFold and other biomedical sources about protein structures and variants. It can keep results in a local knowledge graph.
Apache-2.0 ★ 5 updated 2026-11-16
claude mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcpWhat AlphaFold Sovereign MCP does
The server exposes MCP tools for AlphaFold DB and public biomedical databases such as Open Targets, ClinVar, and gnomAD. A local SQLite knowledge graph supports queries and exports. Results can be written through its API, but automatic saving after each tool call is not wired up.
In online mode, lookup identifiers go to the relevant public sources. DisGeNET queries need a free API key. Set ALPHAFOLD_OFFLINE=1 to block outbound connections; local knowledge-graph tools still work, while upstream queries report that their source is unavailable. The server requires Python 3.11+ and runs through uvx.
AlphaFold results are predictions, not experimental observations, and this server does not validate clinical significance. Qualified human review is required before clinical or regulatory use.
What it helps with
- retrieve a predicted protein structure by identifier
- compare a variant with biomedical database records
- keep query results in a local knowledge graph
- export data from the knowledge graph
Example prompts for the agent
- Find the AlphaFold structure for this protein and explain the result.
- Compare this variant with records from ClinVar and gnomAD.
- Save the query results to the local knowledge graph and export them.
How to install AlphaFold Sovereign MCP
Platform CLI
claude mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcpuvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>
Platform CLI
codex mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcpuvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>
Config file
{
"mcpServers": {
"alphafold-sovereign-mcp": {
"command": "uvx",
"args": [
"alphafold-sovereign-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>
Config file
{
"servers": {
"alphafold-sovereign-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"alphafold-sovereign-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>
Platform CLI
gemini mcp add alphafold-sovereign-mcp uvx alphafold-sovereign-mcpuvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AlphaFold Sovereign MCP
How do I install AlphaFold Sovereign MCP in Claude Code?
Run claude mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcp.
What does AlphaFold Sovereign MCP do?
It provides MCP tools for querying AlphaFold DB and other public biomedical sources. Its local SQLite knowledge graph can also be queried and exported.
What does AlphaFold Sovereign MCP need to run?
It requires Python 3.11+ and uvx. Online queries need network access, and DisGeNET requires its own free API key; ALPHAFOLD_OFFLINE=1 blocks outbound connections.