ncbi-kg-mcp
MCP server for the NCBI Knowledge Graph - a BioLink-compliant glucose metabolism graph with 82,517 nodes and 263,404 edges. Query genes, diseases, variants, proteins, pathways, and more from any LLM.
Install
pip install ncbi-kg-mcp
Configure
Add to your .mcp.json (Claude Code, Cursor, Cline, etc.):
{
"mcpServers": {
"ncbi-kg": {
"command": "ncbi-kg-mcp"
}
}
}
That's it. No API keys, no database credentials, no repo cloning needed.
Tools (5)
| Tool | Input | Description |
|---|---|---|
query |
question: str |
Ask a natural language question - auto-translated to Cypher |
cypher |
query_text: str |
Run a read-only Cypher query directly |
get_stats |
None | Get node and edge counts by type |
get_schema |
None | Get graph schema - node types, relationships, patterns |
get_neighbors |
node_id: str |
Get 1-hop neighbors of a node (e.g., "NCBIGene:2645") |
Example
Ask your LLM: "What genes are associated with MODY?"
The LLM calls the query tool, which translates to Cypher, executes against Neo4j, and returns a synthesized answer with raw data.
Graph Data
- 8 node types: Gene, Disease, SequenceVariant, BiologicalProcess, MolecularActivity, Protein, CellularComponent, Pathway
- 15 relationship types: GENE_ASSOCIATED_WITH_CONDITION, IS_SEQUENCE_VARIANT_OF, CAUSES, INVOLVED_IN, ENABLES, and more
- Sources: NCBI Gene, ClinVar, MedGen, MONDO, GO, UniProt, Reactome
Configuration
| Env Variable | Default | Description |
|---|---|---|
NCBI_KG_API_URL |
https://ncbi-kg-api-production.up.railway.app |
API base URL |
Override the API URL to point to a local backend:
{
"mcpServers": {
"ncbi-kg": {
"command": "ncbi-kg-mcp",
"env": {"NCBI_KG_API_URL": "http://localhost:8001"}
}
}
}
Links
Metadata
Release files for ncbi-kg-mcp 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ncbi_kg_mcp-1.0.1.tar.gz | 5.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ncbi_kg_mcp-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.9 kB
Release files / ncbi_kg_mcp-1.0.1.tar.gz
| Download URL | ncbi_kg_mcp-1.0.1.tar.gz |
|---|---|
| Size | 5.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1feb8969a63649514dd34aadfb775451fe7dee49062ccfd25438e17556deb2b1
|
|
BLAKE2b-256 checksum How to use checksums |
1a3a33ec49b46fe87871ccf8719699ec8057a34636db11acb59b56b872f24584
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.2
|
Release files / ncbi_kg_mcp-1.0.1-py3-none-any.whl
| Download URL | ncbi_kg_mcp-1.0.1-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e043f68533afb918b2e80553c4b85075ae67895179a627152d3242997967c1ec
|
|
BLAKE2b-256 checksum How to use checksums |
9c385d07d07c4448895d4138d35a27d3a6cad10d9003ec39daa0bc5ec855bdcf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.2
|