!AlphaFold MCP Server Logo

AlphaFold MCP Server

A comprehensive Model Context Protocol (MCP) server that provides access to the AlphaFold Protein Structure Database through a rich set of tools and resources for protein structure prediction analysis.

Overview

This MCP server enables seamless integration with AlphaFold's vast collection of protein structure predictions, offering tools for structure retrieval, confidence analysis, batch processing, and visualization preparation. Perfect for researchers, bioinformaticians, and structural biologists working with predicted protein structures.

Features

$3

- Structure Retrieval: Get AlphaFold predictions by UniProt ID
- Multi-format Downloads: Support for PDB, CIF, BCIF, and JSON formats
- Availability Checking: Verify if predictions exist for specific proteins

$3

- Structure Search: Find proteins by name, gene, or organism
- Organism Browsing: List all available structures for specific species
- Coverage Statistics: Get comprehensive organism-level statistics

$3

- Per-residue Confidence: Detailed confidence scores for each amino acid
- Region Analysis: Identify high/low confidence structural regions
- Quality Validation: Assess overall prediction reliability

$3

- Bulk Retrieval: Process multiple proteins simultaneously
- Batch Downloads: Efficient multi-structure downloads
- Parallel Analysis: Confidence analysis for protein sets

$3

- Structure Comparison: Side-by-side analysis of multiple proteins
- Similarity Search: Find structurally related proteins
- Coverage Comparison: Analyze prediction completeness

$3

- PyMOL Scripts: Ready-to-use visualization scripts
- ChimeraX Integration: Confidence-colored structure viewing
- Custom Export Formats: Flexible data export options

Installation

``bash


Clone or create the server directory

npm install

Build the server

npm run build
`

Usage

$3

Add to your MCP configuration:

`json
{
"mcpServers": {
"alphafold-server": {
"command": "node",
"args": ["/path/to/alphafold-server/build/index.js"]
}
}
}
`

$3

`bash


Start the server

npm start

Or run directly

node build/index.js
`

Available Tools

$3

#### get_structure

Retrieve AlphaFold structure prediction for a specific UniProt ID.

Parameters:

- uniprotId (required): UniProt accession (e.g., "P21359", "Q8N726")
- format (optional): Output format - "pdb", "cif", "bcif", or "json" (default: "json")

Example:

`javascript
{
"uniprotId": "P04637",
"format": "json"
}
`

#### download_structure

Download AlphaFold structure file in specified format.

Parameters:

- uniprotId (required): UniProt accession
- format (optional): File format - "pdb", "cif", or "bcif" (default: "pdb")

#### check_availability

Check if AlphaFold structure prediction is available for a UniProt ID.

Parameters:

- uniprotId (required): UniProt accession to check

$3

#### search_structures

Search for available AlphaFold structures by protein name or gene.

Parameters:

- query (required): Search term (protein name, gene name, etc.)
- organism (optional): Filter by organism
- size (optional): Number of results (1-100, default: 25)

#### list_by_organism

List all available structures for a specific organism.

Parameters:

- organism (required): Organism name (e.g., "Homo sapiens", "Escherichia coli")
- size (optional): Number of results (1-100, default: 50)

#### get_organism_stats

Get statistics about AlphaFold coverage for an organism.

Parameters:

- organism (required): Organism name

$3

#### get_confidence_scores

Get per-residue confidence scores for a structure prediction.

Parameters:

- uniprotId (required): UniProt accession
- threshold (optional): Confidence threshold (0-100)

#### analyze_confidence_regions

Analyze confidence score distribution and identify high/low confidence regions.

Parameters:

- uniprotId (required): UniProt accession

#### get_prediction_metadata

Get metadata about the prediction including version, date, and quality metrics.

Parameters:

- uniprotId (required): UniProt accession

$3

#### batch_structure_info

Get structure information for multiple proteins simultaneously.

Parameters:

- uniprotIds (required): Array of UniProt accessions (max 50)
- format (optional): Output format - "json" or "summary" (default: "json")

#### batch_download

Download multiple structure files.

Parameters:

- uniprotIds (required): Array of UniProt accessions (max 20)
- format (optional): File format - "pdb" or "cif" (default: "pdb")

#### batch_confidence_analysis

Analyze confidence scores for multiple proteins.

Parameters:

- uniprotIds (required): Array of UniProt accessions (max 30)

$3

#### compare_structures

Compare multiple AlphaFold structures for analysis.

Parameters:

- uniprotIds (required): Array of UniProt accessions to compare (2-10)

#### find_similar_structures

Find AlphaFold structures similar to a given protein.

Parameters:

- uniprotId (required): Reference UniProt accession
- organism (optional): Filter by organism

$3

#### get_coverage_info

Get information about sequence coverage in the AlphaFold prediction.

Parameters:

- uniprotId (required): UniProt accession

#### validate_structure_quality

Validate and assess the overall quality of an AlphaFold prediction.

Parameters:

- uniprotId (required): UniProt accession

$3

#### export_for_pymol

Export structure data formatted for PyMOL visualization.

Parameters:

- uniprotId (required): UniProt accession
- includeConfidence (optional): Include confidence score coloring (default: true)

#### export_for_chimerax

Export structure data formatted for ChimeraX visualization.

Parameters:

- uniprotId (required): UniProt accession
- includeConfidence (optional): Include confidence score coloring (default: true)

#### get_api_status

Check AlphaFold API status and database statistics.

Parameters: None

Available Resources

$3

#### alphafold://structure/{uniprotId}

MIME Type: application/json
Description: Complete AlphaFold structure prediction for a UniProt ID

#### alphafold://pdb/{uniprotId}

MIME Type: chemical/x-pdb
Description: PDB format structure file for a UniProt ID

#### alphafold://confidence/{uniprotId}

MIME Type: application/json
Description: Per-residue confidence scores for a structure prediction

#### alphafold://summary/{organism}

MIME Type: application/json
Description: Summary of all available structures for an organism

Example Workflows

$3

`javascript
// 1. Check if structure is available
await use_mcp_tool("alphafold-server", "check_availability", {
uniprotId: "P04637",
});

// 2. Get structure metadata
await use_mcp_tool("alphafold-server", "get_prediction_metadata", {
uniprotId: "P04637",
});

// 3. Analyze confidence scores
await use_mcp_tool("alphafold-server", "get_confidence_scores", {
uniprotId: "P04637",
threshold: 70,
});
`

$3

`javascript
// Compare multiple related proteins
await use_mcp_tool("alphafold-server", "compare_structures", {
uniprotIds: ["P04637", "P53350", "P63151"],
});

// Batch confidence analysis
await use_mcp_tool("alphafold-server", "batch_confidence_analysis", {
uniprotIds: ["P04637", "P53350", "P63151"],
});
`

$3

`javascript
// Export for PyMOL with confidence coloring
await use_mcp_tool("alphafold-server", "export_for_pymol", {
uniprotId: "P04637",
includeConfidence: true,
});

// Export for ChimeraX
await use_mcp_tool("alphafold-server", "export_for_chimerax", {
uniprotId: "P04637",
includeConfidence: true,
});
`

$3

`javascript
// Get human protein statistics
await use_mcp_tool("alphafold-server", "get_organism_stats", {
organism: "Homo sapiens",
});

// List available structures
await use_mcp_tool("alphafold-server", "list_by_organism", {
organism: "Homo sapiens",
size: 100,
});
`

API Reference

The server connects to the AlphaFold API at https://alphafold.ebi.ac.uk/api/ and provides structured access to:

- Structure Predictions: Complete protein structure data
- Confidence Scores: Per-residue reliability metrics
- Metadata: Prediction versions, dates, and quality information
- Cross-references: Links to other databases and resources

Error Handling

The server includes comprehensive error handling for:

- Invalid UniProt IDs
- Missing structure predictions
- API connectivity issues
- Rate limiting and timeouts
- Malformed requests

Rate Limiting

Please be mindful of API usage:

- Batch operations are limited to reasonable sizes
- Large requests are automatically chunked
- Built-in delays prevent API overload

Contributing

Contributions are welcome! Please ensure:

- TypeScript type safety
- Comprehensive error handling
- Documentation for new features
- Testing with real AlphaFold data

About

Developed by Augmented Nature - augmentednature.ai

Augmented Nature specializes in creating AI-powered tools and infrastructure for scientific research and data analysis.

License

MIT License - see LICENSE file for details.

Citation

If you use this MCP server in your research, please cite:

- AlphaFold Database: https://alphafold.ebi.ac.uk/
- Model Context Protocol: https://modelcontextprotocol.io/

Support

For issues and questions:

- Check the AlphaFold API documentation
- Review error messages for debugging hints
- Ensure UniProt IDs are valid and current

---

Note: This server provides a convenient interface to AlphaFold data but does not store or cache structure data. All data is retrieved directly from the official AlphaFold API.

Citation

If you use this project in your research or publications, please cite it as follows:

``bibtex @misc{alphafoldmcp2025,
author = {Moudather Chelbi},
title = {AlphaFold MCP Server},
year = {2025},
howpublished = {https://github.com/Augmented-Nature/AlphaFold-MCP-Server},
note = {Accessed: 2025-06-29}