# AlphaFold Sovereign MCP

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: smaniches
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/smaniches/alphafold-sovereign-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/alphafold-sovereign-mcp

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add alphafold-sovereign-mcp -- uvx alphafold-sovereign-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add alphafold-sovereign-mcp uvx alphafold-sovereign-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphafold-sovereign-mcp <command>

## When to use it
- 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
- 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.

## Similar
- [alphafold-database-fetch-and-analyze](https://affpapa.org/en/nevibecode/skills/alphafold-database-fetch-and-analyze.md) — skill · 2400 installs
- [Plan B Asia — Sovereign Mobility for Southeast Asia](https://affpapa.org/en/nevibecode/mcp/plan-b-asia-sovereign-mobility-for-southeast-asia.md) — MCP server · 766 installs
- [fixed-income-sovereign](https://affpapa.org/en/nevibecode/skills/fixed-income-sovereign.md) — skill · 748 installs
- [azure-sovereign-us](https://affpapa.org/en/nevibecode/skills/azure-sovereign-us.md) — skill · 166 installs
- [alphafold-skill](https://affpapa.org/en/nevibecode/skills/alphafold-skill.md) — skill · 14 installs
- [ARADIA | sovereign & private agentic systems](https://affpapa.org/en/nevibecode/mcp/aradia-sovereign-private-agentic-systems.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
