mcp-alphafold
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-alphafold get the AlphaFold structure for P68871"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-AlphaFold
A Model Context Protocol (MCP) server that provides programmatic access to AlphaFold predictions and UniProt data. Built with FastMCP and Python, it offers tools for protein structure predictions, UniProt summaries, and protein annotations.
Requirements
Python ≥ 3.11
uv package manager
⚙️ Configure Claude Desktop
Open Claude Desktop settings
Navigate to Developer section
Click "Edit Config" and add:
{
"mcpServers": {
"mcp_alphafold": {
"command": "uv",
"args": [
"--directory",
"path to /mcp-alphafold/src/mcp_alphafold",
"run",
"mcp-alphafold",
"--transport",
"stdio"
]
}
}
}Restart Claude Desktop and start chatting about biomedical topics!
🐳 Using with Docker
"mcpServers": {
"mcp_alphafold": {
"command": "docker",
"args": [
"run",
"--rm",
"-p", "8050:8050",
"zeinabsheikhi/mcp-alphafold:0.1.0"
]
}
}🔧 Tools
The server offers these core tools:
🧬 AlphaFold Tools
alphafold_predictionRetrieves protein structure predictions using AlphaFold. Input a protein identifier or sequence checksum to get structural predictions.
uniprot_summaryFetches comprehensive protein summaries from UniProt database, including protein function, domains, and other key characteristics.
annotationsRetrieves specific protein annotations including mutations, modifications, and other experimental data. Default annotation type is "MUTAGEN".
Related MCP server: UniProt MCP Server
🚀 Development
📦 Prerequisites
Install
uv(Universal Virtualenv):
# Using pip
pip install uv
# Using Homebrew on macOS
brew install uv
# Using cargo (Rust package manager)
cargo install uvClone the repository and set up development environment:
# Clone the repository
git clone https://github.com/zeinab-sheikhi/mcp-alphafold.git
cd mcp-alphafold
# Create and activate virtual environment using uv
uv venv
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
# Install dependencies including dev dependencies
make installRun the server with
make run-server
🐳 Docker
Build and run the Docker container:
# Build the image
make build-docker
# Run the container
make run-dockerAvailable Tools
3 toolsget_alphafold_predictionA
This tool retrieves all available AlphaFold models for a specified UniProt accession. It allows querying by the UniProt accession or by the CRC64 checksum of the UniProt sequence.
Arguments
qualifier(str): UniProt accession (e.g.,'Q5VSL9').sequence_checksum(str, optional): CRC64 checksum of the UniProt sequence.
Example Input:
qualifier:
Q5VSL9sequence_checksum:
5F9BA1D4C7DE6925
Response Structure
The response will be a list of objects, each containing detailed information about the available AlphaFold models.
Example Output:
[
{
"entryId": "AF-Q5VSL9-F1",
"gene": "STRIP1",
"sequenceChecksum": "5F9BA1D4C7DE6925",
"sequenceVersionDate": "2004-12-07",
"uniprotAccession": "Q5VSL9",
"uniprotId": "STRP1_HUMAN",
"uniprotDescription": "Striatin-interacting protein 1",
"taxId": 9606,
"organismScientificName": "Homo sapiens",
"uniprotStart": 1,
"uniprotEnd": 837,
"uniprotSequence": "MEPAVGGPGPLIVNNKQPQPPPPPPPAAAQPPPGAPRAAAGLLPGGKAREFN...",
"modelCreatedDate": "2022-06-01",
"latestVersion": 4,
"allVersions": [1, 2, 3, 4],
"bcifUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-model_v4.bcif",
"cifUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-model_v4.cif",
"pdbUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-model_v4.pdb",
"paeImageUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-predicted_aligned_error_v4.png",
"paeDocUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-predicted_aligned_error_v4.json",
"amAnnotationsUrl": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-aa-substitutions.csv",
"amAnnotationsHg19Url": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-hg19.csv",
"amAnnotationsHg38Url": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-hg38.csv",
"isReviewed": true,
"isReferenceProteome": true
}
]Inputs: qualifier (required), output_json, sequence_checksum.
get_annotationsB
This tool retrieves all annotations for a specified UniProt residue range. It allows querying by the UniProt accession and the annotation type (e.g., MUTAGEN for AlphaMissense).
Arguments
qualifier(str): UniProt accession (e.g.,'Q5VSL9').annotation_type(str): Type of annotation (e.g.,'MUTAGEN'for AlphaMissense).
Example Input:
qualifier:
Q5VSL9annotation_type:
MUTAGEN
Response Structure
The response includes detailed information about the UniProt entry and its associated annotations.
Example Output:
{
"accession": "Q5VSL9",
"id": "STRP1_HUMAN",
"sequence": "MEPAVGGPGPLIVNNKQPQPPPPPPPAAAQPPPGAPRAAAGLLPGGKAREFNRNQRKDSEGYSESPDLEFEYADTDKWAAELSELYSYTEGPEFLMNRKCFEEDFRIHVTDKKWTELDTNQHRTHAMRLLDGLEVTAREKRLKVARAILYVAQGTFGECSSEAEVQSWMRYNIFLLLEVGTFNALVELLNMEIDNSAACSSAVRKPAISLADSTDLRVLLNIMYLIVETVHQECEGDKAEWRTMRQTFRAELGSPLYNNEPFAIMLFGMVTKFCSGHAPHFPMKKVLLLLWKTVLCTLGGFEELQSMKAEKRSILGLPPLPEDSIKVIRNMRAASPPASASDLIEQQQKRGRREHKALIKQDNLDAFNERDPYKADDSREEEEENDDDNSLEGETFPLERDEVMPPPLQHPQTDRLTCPKGLPWAPKVREKDIEMFLESSRSKFIGYTLGSDTNTVVGLPRPIHESIKTLKQHKYTSIAEVQAQMEEEYLRSPLSGGEEEVEQVPAETLYQGLLPSLPQYMIALLKILLAAAPTSKAKTDSINILADVLPEEMPTTVLQSMKLGVDVNRHKEVIVKAISAVLLLLLKHFKLNHVYQFEYMAQHLVFANCIPLILKFFNQNIMSYITAKNSISVLDYPHCVVHELPELTAESLEAGDSNQFCWRNLFSCINLLRILNKLTKWKHSRTMMLVVFKSAPILKRALKVKQAMMQLYVLKLLKVQTKYLGRQWRKSNMKTMSAIYQKVRHRLNDDWAYGNDLDARPWDFQAEECALRANIERFNARRYDRAHSNPDFLPVDNCLQSVLGQRVDLPEDFQMNYDLWLEREVFSKPISWEELLQ",
"annotation": [
{
"type": "MUTAGEN",
"description": "AM score",
"source_name": "AFDB",
"source_url": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-aa-substitutions.csv",
"evidence": "COMPUTATIONAL/PREDICTED",
"residues": [1, 2, 3, ...],
"regions": [
{
"start": 1,
"end": 837,
"annotation_value": [0.3234, 0.3281, ...],
"unit": null
}
]
}
]
}Inputs: qualifier (required), output_json, annotation_type.
get_uniprot_summaryC
This tool fetches AlphaFold model predictions for a given UniProt residue range. The tool takes in a UniProt accession number (AC), entry name (ID), or CRC64 checksum and returns detailed information about the structure models available for the specified sequence range.
Arguments
qualifier(str): UniProtKB accession number (AC), entry name (ID), or CRC64 checksum of the UniProt sequence (e.g.,'Q5VSL9').
Example Input:
qualifier:
Q5VSL9
Response Structure
The response includes detailed information about the UniProt entry and its associated AlphaFold models.
Example Response:
{
"uniprot_entry": {
"ac": "Q5VSL9",
"id": "STRP1_HUMAN",
"uniprot_checksum": "5F9BA1D4C7DE6925",
"sequence_length": 837,
"segment_start": 1,
"segment_end": 837
},
"structures": [
{
"summary": {
"model_identifier": "AF-Q5VSL9-F1",
"model_category": "AB-INITIO",
"model_url": "https://alphafold.ebi.ac.uk/files/AF-Q5VSL9-F1-model_v4.cif",
"model_format": "MMCIF",
"model_type": null,
"model_page_url": "https://alphafold.ebi.ac.uk/entry/Q5VSL9",
"provider": "AlphaFold DB",
"number_of_conformers": null,
"ensemble_sample_url": null,
"ensemble_sample_format": null,
"created": "2022-06-01",
"sequence_identity": 1,
"uniprot_start": 1,
"uniprot_end": 837,
"coverage": 1,
"experimental_method": null,
"resolution": null,
"confidence_type": "pLDDT",
"confidence_version": null,
"confidence_avg_local_score": 80.82,
"oligomeric_state": null,
"preferred_assembly_id": null,
"entities": [
{
"entity_type": "POLYMER",
"entity_poly_type": "POLYPEPTIDE(L)",
"identifier": "Q5VSL9",
"identifier_category": "UNIPROT",
"description": "Striatin-interacting protein 1",
"chain_ids": [
"A"
]
}
]
}
}
]
}Inputs: qualifier (required), output_json.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
get_alphafold_prediction and get_uniprot_summary both retrieve AlphaFold model information for a UniProt accession, with overlapping purposes. The descriptions do not clearly distinguish when to use one over the other, causing potential misselection. get_annotations is the only clearly distinct tool.
All tool names follow a consistent get_<noun> pattern using snake_case. This predictable naming convention makes the tool set easy to navigate.
With only 3 tools, the server is well-scoped and focused on AlphaFold data retrieval. Each tool has a meaningful role, even though two overlap functionally.
The server covers the core operations for AlphaFold: listing models, fetching a summary, and retrieving annotations. There are no obvious gaps for the intended domain, as structure URLs are included in responses.
Maintenance
Related MCP Connectors
Federated protein structure & annotation across experimental (PDB) and predicted (AlphaFold) models.
Protein analysis: ESM-2/ESMC embeddings, mutation scoring, landscape scans, ESMFold structure.
Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.
Connect AI clients to biomedical data and tools.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to access protein information directly from UniProt, allowing retrieval of protein names, functions, sequences, and organism data by accession number.214MIT
- AlicenseBqualityDmaintenanceProvides seamless access to UniProtKB protein database, enabling queries for protein entries, sequences, Gene Ontology annotations, full-text search, and ID mapping across 200+ database types.542 PyPI2MIT
- AlicenseNot gradedqualityCmaintenanceProvides access to AlphaFold predicted protein 3D structures from EBI, enabling retrieval of prediction metadata, summaries, annotations, and UniProt data.101 npm1MIT
- AlicenseNot gradedqualityCmaintenanceProvides access to UniProt protein sequence and function knowledge base, enabling search and retrieval of protein entries, proteomes, taxonomy, and feature annotations.308 npmMIT