Skip to main content

scientific-data-mcp

PyPI

科研实体数据 MCP —— 化合物 / 生物活性 / 蛋白序列与结构 / 文献元数据的免费官方 API 直连。一个 server,16 个基础工具(配 Materials Project key 时 17 个;BioGRID key 解锁互作 source,不增工具),零额度。同类输入输出的源合并为一个工具,用 kind / by 参数切换。

与 paper-search(文献检索 + RAG)、finance-mcp(金融/宏观)互补,不做重复。

定位

项目 管什么 不管
finance-mcp 金融/宏观行情 科研
paper-search 学术文献检索 + RAG 入 OpenWebUI 实体数据
scientific-data-mcp(本项目) 科研实体数据:化合物、活性、蛋白、结构、文献元数据 跨库文献检索、全文下载、RAG

边界一句话:paper-search 管"找论文/读论文/入 RAG",本项目管"查实体数据"。PubMed 只做 pmid/doi → 结构化记录,不做 pubmed_search。

为什么

kimi datasource 把一批本来就免 key 的官方科研 API(PubChem / ChEMBL / UniProt / PDB / PubMed)包装成收费额度源。finance-mcp 在 2026-09-13 的去重中把这批源摘除,每源都有 live 实测的免费端点证据(见 docs/research/kimi-sources/)。本项目是这批源的免费直连落点。

源与工具

十五个基础源完全免 key(PubChem / ChEMBL / UniProt / RCSB PDB / WHO / STRING / openFDA / ClinicalTrials.gov / AlphaFold DB / Open Targets / Reactome / NCBI Gene / ClinVar / InterPro / QuickGO),PubMed / NCBI Gene / ClinVar 可选 NCBI_API_KEY 提速(3→10 req/s);Materials Project 和 BioGRID 需要免费 key:MP 未配时 material 不注册;BioGRID 未配时 protein_interactions(source="biogrid") 返回明确错误,STRING 仍可用。openFDA 可选 key 只提额度。申请步骤见 docs/CREDENTIALS.md。

工具 源 说明
chem_compound PubChem 化合物记录:identifier + id_type(name/cid/smiles/inchikey);可选 properties 指定 PubChem 属性集(省略为默认全集)
chem_similar_compounds PubChem 结构相似性(POST + ListKey 轮询),返回 CID 列表
chembl_data ChEMBL kind="search"(query/resource)、"activities"(chembl_id 或 target_chembl_id)、"mechanisms"(chembl_id);统一列表 envelope
protein_record UniProt / RCSB / AlphaFold kind="uniprot" 取条目(可选全序列);kind="pdb" 取结构条目 + 实体摘要;kind="alphafold" 取预测模型(pLDDT、PDB/CIF/PAE 链接)
protein_search UniProt / RCSB kind="uniprot" 用 UniProt 查询语法;kind="pdb" 全文检索;统一 next_cursor
protein_map_ids UniProt 官方 ID Mapping(submit → poll)
pubmed_record PubMed pmid / doi → 标题、作者、期刊、年卷期页、摘要、DOI、PMCID
who_data WHO GHO 按指标代码查国家/年份/性别的健康统计(如 WHOSIS_000001)
material Materials Project(需免费 key) by="id" 单条;by="formula" / "chemsys" / "elements" 检索;统一列表 envelope
protein_interactions STRING / BioGRID source="string"(免 key,含 combined/evidence scores)或 "biogrid"(需 key,含实验系统/PubMed);genes 支持 `BRCA1
openfda openFDA endpoint="drug/label" / "drug/event" / "drug/enforcement" + query(field:term);无匹配是 count: 0;可选 key 提额度
clinical_trials ClinicalTrials.gov v2 自由文本检索 + status 过滤;返回 NCT id/标题/状态/分期/干预/入组/赞助方 + next_cursor
opentargets Open Targets entity="target" 查靶点→疾病关联;entity="disease" 查疾病→靶点关联;score 0-1
pathways Reactome 按基因/通路名检索通路;默认人类,可传空字符串查所有物种
gene_record NCBI Gene 基因符号或 NCBI Gene ID → 符号、描述、染色体、位置、别名、摘要、物种
clinvar ClinVar 按基因/变异/临床意义检索;返回 VCV、分类、review status、条件、基因、蛋白改变
protein_annotations InterPro / QuickGO source="interpro" 取结构域/家族条目;source="quickgo" 取 GO 注释

所有工具只返回上游真实字段:缺字段就是上游没有,不推断、不补全。失败返回 {"error": ..., "source": ...},不会让一次调用炸掉整轮对话。

如果错误里出现 "suspect_drift": true / "action": "contact_admin",表示上游返回结构与适配器不一致(接口可能漂移),不是限流或网络问题:不要用相同参数重试,请告知用户联系管理员更新对应 provider。rate_limited / unavailable / auth / not_found 不带这个标记。

安装

pip install scientific-data-mcp
# 或
uvx scientific-data-mcp
# 开发安装
uv venv --python 3.12 .venv
uv pip install -e '.[dev]' --python .venv/bin/python

运行

stdio(mcpo / 本地 MCP 客户端):

scientific-data-mcp

Streamable HTTP:

scientific-data-mcp --http --host 0.0.0.0 --port 8000

mcpo 配置示例(config.json):

{
  "mcpServers": {
    "scientific-data": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/xyonium/scientific-data-mcp", "scientific-data-mcp"],
      "env": {}
    }
  }
}

可选 key(不是必需)

"env": {
  "NCBI_API_KEY": "免费申请,PubMed 限速 3 → 10 req/s",
  "NCBI_EMAIL": "you@example.com",
  "MATERIALS_PROJECT_API_KEY": "免费申请;不配则不注册材料工具",
  "BIOGRID_ACCESS_KEY": "免费申请;不配则 protein_interactions 的 biogrid source 不可用",
  "OPENFDA_API_KEY": "可选;只提额度,不配也能用"
}

申请步骤、各源是否有 key、以及 M6 扩展源(NOAA / NASA)的入口见 docs/CREDENTIALS.md。不配任何 key 时 16 个基础源全部可用(PubMed / Gene / ClinVar 慢一些),MP 工具隐藏、BioGRID source 不可用。

Docker

docker build -t scientific-data-mcp:dev .
docker run --rm -p 8000:8000 scientific-data-mcp:dev --http --host 0.0.0.0

PyPI 发布

包名 scientific-data-mcp,已发布到 PyPI。首次发布通过 trusted publishing 完成;之后 push v* tag 自动发布。

一次性配置(推荐 trusted publishing,免 API token):

  1. 注册 PyPI 账号并开启 2FA。
  2. 打开 https://pypi.org/manage/account/publishing/ ,添加 pending publisher:
    • PyPI project name: scientific-data-mcp
    • Owner: xyonium
    • Repository: scientific-data-mcp
    • Workflow name: publish.yml
    • Environment: pypi
  3. 仓库 Settings → Secrets and variables → Actions → Variables 新建 PYPI_PUBLISH=true。
  4. 之后 push v* tag(或手动运行 publish workflow)即构建 sdist/wheel 并上传。

工作流在 .github/workflows/publish.yml:tag 触发时只有在 PYPI_PUBLISH=true 才发布,避免未配置时 CI 变红。首次上传会自动创建 PyPI 项目并占用这个名字。

数据源清单追踪

docs/research/kdense-databases.json 是 K-Dense scientific-agent-skills database-lookup 的数据库快照(当前 v1.8,80 库,2026-09-30 复核)。

python scripts/kdense_sources.py --check    # 与上游 diff
python scripts/kdense_sources.py --update   # 刷新快照

GitHub Action kdense-sources 每季度(1/4/7/10 月 1 日)自动扫描;上游新增或移除数据库时开 issue(已有 open issue 则追加评论)。

80 个库逐个的“已实现 / M6 / 归兄弟项目 / 不做”决定见 docs/research/kdense-coverage.md。

开发

pytest -q                 # hermetic(respx mock),0 egress
ruff check .
python scripts/live_smoke.py   # 真实打 16 个基础上游(配 key 时 18 个),人工跑

License

MIT

Metadata

Release files for scientific-data-mcp 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scientific-data-mcp 0.8.0
File Size Uploaded Provenance Actions
scientific_data_mcp-0.8.0.tar.gz 112.8 kB With provenance Details for scientific_data_mcp-0.8.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for scientific-data-mcp 0.8.0
File Interpreter ABI Platform Actions
scientific_data_mcp-0.8.0-py3-none-any.whl Python 3 none any Details for scientific_data_mcp-0.8.0-py3-none-any.whl

Total release size: 172.0 kB

Release files / scientific_data_mcp-0.8.0.tar.gz

Download URL scientific_data_mcp-0.8.0.tar.gz
Size 112.8 kB
Tags Source
SHA-256 checksum
How to use checksums
fb2c83366cb8493f4e1d5515ecbb7c95ff1daa6f8f20c155816eff7cc0b20680
BLAKE2b-256 checksum
How to use checksums
987f34857d7e0aa11277b1fea92b980084af1e46f78993f481151c0801a1a945
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / scientific_data_mcp-0.8.0-py3-none-any.whl

Download URL scientific_data_mcp-0.8.0-py3-none-any.whl
Size 59.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbbe9be9db7cf17215d3781651274f6f77c8a701c7acd549b99138cf76ee3931
BLAKE2b-256 checksum
How to use checksums
69f78bdb1ff7e7da84deb36718feb94a38f3cb527a93166fac1887fe5973962e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for scientific-data-mcp 0.8.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for scientific_data_mcp-0.8.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page