@iflow-mcp/reactome-server
Version:
Production-ready MCP server for Reactome pathway and systems biology data - Developed by Augmented Nature
277 lines (205 loc) • 7.16 kB
Markdown
Model Context Protocol server for accessing Reactome pathway and systems biology data.
[](https://reactome.org/)
Developed by [Augmented Nature](https://augmentednature.ai) - Advancing AI for Scientific Discovery
**All 8 tools working with live Reactome API data:**
- 🔍 **Pathway Search** - Search biological pathways by name, process, keywords
- 📊 **Pathway Details** - Comprehensive pathway information and components
- 🧬 **Gene-to-Pathways** - Find pathways containing specific genes/proteins
- 🦠 **Disease Pathways** - Disease-associated biological mechanisms
- 🌲 **Pathway Hierarchy** - Parent/child relationships and pathway structure
- 🧪 **Pathway Participants** - All molecules participating in pathways
- ⚗️ **Biochemical Reactions** - Detailed reaction information
- 🔗 **Protein Interactions** - Molecular interactions within pathways
```bash
npm install
npm run build
node build/index.js
```
```json
{
"mcpServers": {
"reactome-server": {
"command": "node",
"args": ["/path/to/reactome-server/build/index.js"]
}
}
}
```
```bash
node /path/to/reactome-server/build/index.js
```
**Search for biological pathways by name, description, or keywords**
```json
{
"name": "search_pathways",
"arguments": {
"query": "cell cycle", // Pathway name, process, or keywords
"type": "pathway", // Optional: pathway, reaction, protein, complex, disease
"size": 20 // Optional: 1-100 results (default: 20)
}
}
```
**Example Results:**
- **Cell Cycle** (R-HSA-1640170) - Cell cycle progression and regulation
- **Cell Cycle Checkpoints** (R-HSA-69620) - Quality control mechanisms
- **Mitotic G1-G1/S phases** (R-HSA-453279) - G1 phase progression
**Get comprehensive information about a specific pathway**
```json
{
"name": "get_pathway_details",
"arguments": {
"id": "R-HSA-1640170" // Reactome pathway stable identifier
}
}
```
**Find all pathways containing a specific gene or protein**
```json
{
"name": "find_pathways_by_gene",
"arguments": {
"gene": "BRCA1", // Gene symbol or UniProt ID
"species": "Homo sapiens" // Optional: species (default: Homo sapiens)
}
}
```
**Find disease-associated pathways and mechanisms**
```json
{
"name": "find_pathways_by_disease",
"arguments": {
"disease": "cancer", // Disease name or DOID identifier
"size": 25 // Optional: 1-100 pathways (default: 25)
}
}
```
**Get hierarchical structure and parent/child relationships**
```json
{
"name": "get_pathway_hierarchy",
"arguments": {
"id": "R-HSA-1640170" // Reactome pathway stable identifier
}
}
```
**Get all molecules (proteins, genes, compounds) in a pathway**
```json
{
"name": "get_pathway_participants",
"arguments": {
"id": "R-HSA-1640170" // Reactome pathway stable identifier
}
}
```
**Get all biochemical reactions within a pathway**
```json
{
"name": "get_pathway_reactions",
"arguments": {
"id": "R-HSA-1640170" // Reactome pathway stable identifier
}
}
```
**Get protein-protein interactions within pathways**
```json
{
"name": "get_protein_interactions",
"arguments": {
"pathwayId": "R-HSA-1640170", // Reactome pathway stable identifier
"interactionType": "all" // Optional: protein-protein, regulatory, catalysis, all
}
}
```
Access Reactome data through standardized URIs:
- `reactome://pathway/{id}` - Complete pathway information
- `reactome://reaction/{id}` - Detailed reaction information
- `reactome://protein/{id}` - Protein details and associations
- `reactome://disease/{id}` - Disease-associated pathways
- `reactome://search/{query}` - Search results
```bash
{"name": "search_pathways", "arguments": {"query": "DNA repair", "size": 10}}
{"name": "get_pathway_details", "arguments": {"id": "R-HSA-5696394"}}
{"name": "find_pathways_by_gene", "arguments": {"gene": "BRCA1"}}
{"name": "get_pathway_participants", "arguments": {"id": "R-HSA-5696394"}}
```
```bash
{"name": "find_pathways_by_disease", "arguments": {"disease": "cancer", "size": 15}}
{"name": "get_pathway_hierarchy", "arguments": {"id": "R-HSA-5637815"}}
{"name": "get_pathway_reactions", "arguments": {"id": "R-HSA-5637815"}}
```
```bash
{"name": "find_pathways_by_gene", "arguments": {"gene": "EGFR"}}
{"name": "get_protein_interactions", "arguments": {"pathwayId": "R-HSA-177929"}}
{"name": "get_pathway_participants", "arguments": {"id": "R-HSA-177929"}}
```
**Reactome provides curated data for:**
- **25,000+ reactions** across all major biological processes
- **14,000+ proteins** with detailed functional annotations
- **2,500+ pathways** covering cellular and molecular processes
- **20+ species** including human, mouse, rat, and model organisms
- **Cross-references** to UniProt, ChEMBL, Ensembl, and other databases
**Key Biological Areas:**
- Signal transduction pathways
- Metabolic processes and networks
- Gene regulation and expression
- Cell cycle and DNA repair
- Immune system responses
- Disease mechanisms and drug action
- Developmental biology processes
- **TypeScript** implementation with robust type safety
- **Reactome Content Service API** for efficient data retrieval
- **MCP Protocol** compliant JSON-RPC communication
- **Error Handling** with comprehensive validation
- **Production Ready** with 30s timeouts and proper logging
- **Base URL**: `https://reactome.org/ContentService`
- **Version**: Reactome v79 (latest)
- **Rate Limits**: Generous for research use
- **Authentication**: None required
- **Format**: REST API with JSON responses
## 🤝 **Contributing**
1. Fork the repository
2. Make your changes
3. Submit a pull request
## Citation
If you use this project in your research or publications, please cite it as follows:
```bibtex @misc{reactomemcp2025,
author = {Moudather Chelbi},
title = {Reactome MCP Server},
year = {2025},
howpublished = {https://github.com/Augmented-Nature/Reactome-MCP-Server},
note = {Accessed: 2025-06-29}