zjunlp/scp-cisreg

SCP-CISREG (SciGraph) MCP client

What this SCP is

CISREG is a large-scale genomic regulation knowledge graph. It standardizes enhancers, topologically associated domains (TADs), and their interactions with genes, proteins, and phenotypes in RDF, aligning genomic coordinates with biological functions to enable complex reasoning about gene regulation.

Connection info

• MCP server URL:
  • https://scp.intern-ai.org.cn/api/v1/mcp/37/SciGraph
• Auth header:
  • SCP-HUB-API-KEY: {API-KEY}

Install

pip install mcp

Configure (MCP config JSON)

{
  "mcpServers": {
    "SciGraph": {
      "type": "streamableHttp",
      "description": "这是一款面向科学研究的统一知识查询服务，集成了化学、生物等多个学科领域的知识图谱数据，支持跨学科知识检索、实体关系查询、领域知识问答等操作",
      "url": "https://scp.intern-ai.org.cn/api/v1/mcp/37/SciGraph",
      "headers": {
        "SCP-HUB-API-KEY": "{API-KEY}"
      }
    }
  }
}

Tools

query_cypher

Execute a Cypher query and return JSON results.

Arguments:

• cypher (string, required)
• kg_name (string|null, optional, default null)
• limit (int, optional, default 100)

Example arguments (CISREG):

{
  "cypher": "MATCH (e:Experiment:CISREG) RETURN e.id as experiment_id",
  "kg_name": "CISREG",
  "limit": 5
}

get_kg_statistics

Return graph statistics.

Example arguments:

{ "kg_name": "CISREG" }

get_entity_details

Return entity details.

Example arguments:

{ "entity_identifier": "experiment_1", "kg_name": "CISREG" }

get_experiment_workflow

Return the full workflow of an experiment.

Example arguments:

{ "experiment_id": "experiment_1" }

Python example (streamable HTTP)

import asyncio
import json
from mcp.client.streamable_http import streamablehttp_client
from mcp.client.session import ClientSession

SERVER_URL = "https://scp.intern-ai.org.cn/api/v1/mcp/37/SciGraph"

async def main():
    transport = streamablehttp_client(
        url=SERVER_URL,
        headers={"SCP-HUB-API-KEY": "sk-xxx"},
    )
    read, write, get_session_id = await transport.__aenter__()

    session_ctx = ClientSession(read, write)
    session = await session_ctx.__aenter__()
    await session.initialize()

    # Example: stats for CISREG
    result = await session.call_tool(
        "get_kg_statistics",
        arguments={"kg_name": "CISREG"},
    )
    data = json.loads(result.content[0].text)
    print(data)

    await session_ctx.__aexit__(None, None, None)
    await transport.__aexit__(None, None, None)

if __name__ == "__main__":
    asyncio.run(main())

Citation

Mulero-Hernández, J., Mironov, V., Miñarro-Giménez, J. A., Kuiper, M., & Fernández-Breis, J. T. (2024). Integration of chromosome locations and functional aspects of enhancers and topologically associating domains in knowledge graphs enables versatile queries about gene regulation. Nucleic Acids Research, 52(15), e69. https://doi.org/10.1093/nar/gkae566

Reference

For the full scraped page text/schemas, read:

• references/source.md