academica-sh/academica-mcp

Academica MCP
面向科学、医疗和金融智能体的证据基础设施。
通过八个只读的模型上下文协议服务器，提供生物医学文献、临床试验、医生-产业支付、医疗服务提供者记录、SEC 持股、SEC 申报基本面、提供者市场情报和报销证据。

MCP
Access
Authentication
License

获取 API 密钥 · 文档 · 报告问题

五个证据界面。一个协议。

| | 服务器 | 证据界面 | 插件 |
|---|---|---|---|
| ◉ | PubMed | 生物医学引文、摘要、作者信息、期刊和标识符 | academica-pubmed |
| ⌁ | Clinical Trials | 研究方案、招募状态、干预措施、资格标准和结果 | academica-clinical-trials |
| ◇ | Open Payments | CMS 价值转移、制造商、医生和所有权权益 | academica-open-payments |
| ✣ | Healthcare Providers | NPI 身份、专科、分类法、资质和执业地点 | academica-hcp |
| § | SEC Ownership & Flows | 13F 和 N-PORT 持仓、管理人投资组合、证券持有人、13D/G 和 Form 4 事件 | academica-sec-ownership |
| 10-K | SEC Filings & Fundamentals | 申报章节、时间顺序、XBRL 事实、指标追踪、同行比较和披露差异 | academica-sec-filings |
| NPI | Provider & Account Intelligence | 提供者身份、声明的组织关系、观察到的利用率、账户排名和市场比较 | academica-provider-market |
| $ | Reimbursement & Market Access | 原生费率、代码证据、提供者经济学、管辖区覆盖和观察到的操作量 | academica-reimbursement |

使用 Claude Code 在一分钟内安装一个服务器

/plugin marketplace add academica-sh/academica-mcp
/plugin install academica-pubmed@academica

在加载插件之前设置 API 密钥：

export ACADEMICA_API_KEY="ak_…"

[!IMPORTANT]
一个仓库是分发权威；激活仍然因客户端而异。 Claude Code 和 Codex 公开八个可独立安装的插件。Cursor、Pi、Hermes 以及可选的聚合配置会一起注册八个命名服务器，并让客户端控制哪些工具保持启用。
从研究问题到可引用的证据

flowchart LR
A[研究代理Claude · Cursor · MCP 客户端]
B[Academica MCP经过身份验证的只读工具]
C[原始记录保留标识符和来源]
A --> B --> C

托管端点

| 服务器 | 可流式传输的 HTTP 端点 | OpenAPI 架构 |
|---|---|---|
| PubMed | https://academica.sh/api/mcp/pubmed | openapi.json |
| Clinical Trials | https://academica.sh/api/mcp/clinical-trials | openapi.json |
| Open Payments | https://academica.sh/api/mcp/open-payments | openapi.json |
| Healthcare Providers | https://academica.sh/api/mcp/hcp | openapi.json |
| SEC Ownership & Flows | https://academica.sh/api/mcp/sec-ownership | openapi.json |
| SEC Filings & Fundamentals | https://academica.sh/api/mcp/sec-filings | openapi.json |
| Provider & Account Intelligence | https://academica.sh/api/mcp/provider-market | openapi.json |
| Reimbursement & Market Access | https://academica.sh/api/mcp/reimbursement | openapi.json |

所有八个服务器均使用可流式传输的 HTTP，并在 Authorization: Bearer  请求头中接受 Academica API 密钥。

结果保留的内容

Academica 工具返回结构化证据记录，而非无法追溯的文本。根据所选服务器的不同，结果可能保留：

- 来源标识符，例如 PMID、NCT ID、NPI 和 CMS 记录标识符；
- 官方标题、状态、日期、组织机构和命名实体；
- 研究干预措施、资格标准、申办方和地点；
- 付款类别、金额、制造商和承保受益人；
- 提供者资质、分类法、专业领域和执业地点。

来源标识符支持对相应原始记录进行检查。检索到的记录是研究证据，而非医疗建议，并且结果集中未出现某项内容，并不代表其在现实世界中不存在。

客户端设置

Claude Code

/plugin marketplace add academica-sh/academica-mcp
/plugin install academica-pubmed@academica

独立安装其他证据界面：

/plugin install academica-clinical-trials@academica
/plugin install academica-open-payments@academica
/plugin install academica-hcp@academica
/plugin install academica-sec-ownership@academica
/plugin install academica-sec-filings@academica
/plugin install academica-provider-market@academica
/plugin install academica-reimbursement@academica

Claude Team 和 Cowork

将每个所需的端点添加为自定义 Web 连接器，并提供 Academica 密钥作为 Bearer 身份验证。

Name: Academica PubMed
URL: https://academica.sh/api/mcp/pubmed
Authorization: Bearer

Cursor

将该仓库作为 Cursor 插件安装。在 Plugins → Configure 下，设置所需的 ACADEMICA_API_KEY 变量。原生清单会注册全部八个服务器，而不会将密钥存储在仓库中。

Codex

export ACADEMICA_API_KEY="ak_…"
codex plugin marketplace add academica-sh/academica-mcp
codex plugin add academica-pubmed@academica

Codex 市场包含八个可独立安装的插件。每个插件都使用原生 bearer_token_env_var 凭据解析。

OpenCode

将 clients/opencode 中的一个文件复制或合并到适用的 opencode.json 中。单个服务器示例和可选的全体服务器配置使用 {env:ACADEMICA_API_KEY} 替换，并禁用 OAuth。

Hermes Agent

将 clients/hermes/config.yaml 合并到 ~/.hermes/config.yaml，并将 ACADEMICA_API_KEY 暴露给 Hermes。八个可直接用于上游的目录清单提供在 clients/hermes/catalog 下。

DeepSeek Harness

export ACADEMICA_API_KEY="ak_…"
dsh plugin --profile web add github:academica-sh/academica-mcp

该包通过 cordis.patch.yml 挂载 DeepSeek 官方 Streamable HTTP MCP 客户端的八个实例。安装按 Harness 配置文件进行。

Pi

export ACADEMICA_API_KEY="ak_…"
pi install git:github.com/academica-sh/academica-mcp

Pi 包会加载由 pi-mcp-adapter 支持的 Academica 扩展。全部八个服务器均可用；可通过适配器控件启用或禁用各个条目。

Smithery

Smithery 将每个托管端点视为独立的目录服务器。八条发布记录和共享的会话授权架构维护在 smithery 下。

会话字段接受完整的授权值：

Bearer

仓库或目录元数据中不存储任何密钥。

通用 MCP 客户端

Transport: Streamable HTTP
URL: https://academica.sh/api/mcp/
Header: Authorization: Bearer
有效的服务器路径为 pubmed、clinical-trials、open-payments、hcp、sec-ownership、sec-filings、provider-market 和 reimbursement。

ChatGPT Actions 和 OpenAPI 客户端

导入所需证据界面的 schema：

https://academica.sh/api/mcp/pubmed/openapi.json
https://academica.sh/api/mcp/clinical-trials/openapi.json
https://academica.sh/api/mcp/open-payments/openapi.json
https://academica.sh/api/mcp/hcp/openapi.json
https://academica.sh/api/mcp/sec-ownership/openapi.json
https://academica.sh/api/mcp/sec-filings/openapi.json
https://academica.sh/api/mcp/provider-market/openapi.json
https://academica.sh/api/mcp/reimbursement/openapi.json

使用 Bearer 方案的 API Key 身份验证。隐私政策 URL 为 https://academica.sh/legal/privacy。

客户端兼容性

| 客户端 | 仓库集成 | 身份验证 | 选择模型 |
|---|---|---|---|
| Claude Code | .claude-plugin/marketplace.json 加上八个插件包 | ACADEMICA_API_KEY 环境变量替换 | 独立安装每个证据界面 |
| Cursor | .cursor-plugin/plugin.json | 在 Plugins → Configure 下设置必需密钥 | 一个插件暴露八个命名服务器 |
| Codex | .agents/plugins/marketplace.json 加上八个 .codex-plugin 清单 | 原生 bearer_token_env_var | 独立安装每个证据界面 |
| OpenCode | clients/opencode/*.json | {env:ACADEMICA_API_KEY} 请求头替换 | 单个文件加上可选的 all.json |
| Hermes Agent | clients/hermes/config.yaml | ${ACADEMICA_API_KEY} 请求头替换 | 一个配置中包含八个服务器 |
| DeepSeek Harness | package.json 加上 cordis.patch.yml | Cordis 包中由环境变量支持的请求头 | 每个已安装配置文件对应八个 MCP 客户端实例 |
| Pi | package.json 加上 extensions/academica-mcp.ts | 通过 pi-mcp-adapter 使用由环境变量支持的请求头 | 一个包；服务器可单独禁用 |
| Smithery | smithery/ 下的八条托管 URL 服务器记录 | 会话范围的 Authorization 请求头映射 | 每个证据界面对应一个目录条目 |
| Agent Plugins | 根目录 plugin.json 加上 mcp.json | 由客户端管理；可移植标准不存储任何密钥引用 | 一个可移植插件声明八个服务器 |

可移植 Agent Plugins 文件有意不包含 Authorization 请求头。需要 bearer 身份验证的客户端使用上面列出的原生集成。

已验证的分发门禁

- 根 Agent Plugins 清单通过 1.0.0 schema 验证。
- 全部八个 Codex 插件均声明原生 bearer-token 环境变量解析。
- 全部八个 OpenCode 配置均通过 JSON 验证，并保留禁用 OAuth 的 bearer 身份验证。
- Hermes 配置和目录清单可作为 YAML 解析。
- Pi 包可从本地 Git 源安装，并导出一个有效的扩展函数。
- npm 包包含 Pi 扩展和 DeepSeek Cordis bundle；依赖审计报告零已知漏洞。
- Smithery 发布记录列举了八个托管服务器，且会话 schema 通过 JSON Schema 2020-12 验证。
- 所有 JSON 清单均可解析，且未提交任何运营 API 密钥。

这些检查证明了打包和配置的兼容性。目录审批、npm 发布和经认证的证据查询是独立的发布关卡。

为证据工作而构建

| 属性 | 约定 |
|---|---|
| 设计上只读 | 检索工具无法修改上游科学或公共记录。 |
| 来源可解析 | 稳定标识符支持对底层记录的检查。 |
| 范围化凭证 | 用户签发的密钥支持撤销和证据面授权。 |
| 可组合 | 独立服务器支持聚焦型代理和跨面工作流。 |

仓库结构图

academica-mcp/
├── plugin.json                         # Open Plugins 身份标识
├── mcp.json                            # 可移植的八服务器 MCP 目录
├── .cursor-plugin/plugin.json          # Cursor 变量和经认证的 MCP
├── .agents/plugins/marketplace.json    # Codex 市场目录
├── .claude-plugin/marketplace.json      # Claude Code 市场目录
├── package.json                        # DeepSeek Harness 和 Pi 包
├── cordis.patch.yml                    # DeepSeek MCP 客户端 bundle
├── extensions/                         # Pi MCP 适配器扩展
├── clients/                            # OpenCode 和 Hermes 配置
├── smithery/                           # 托管服务器发布记录和会话 schema
├── plugins/
│   ├── academica-pubmed/                # Claude 和 Codex 插件清单
│   ├── academica-clinical-trials/
│   ├── academica-open-payments/
│   ├── academica-hcp/
│   ├── academica-sec-ownership/
│   ├── academica-sec-filings/
│   ├── academica-provider-market/
│   └── academica-reimbursement/
└── registry/
├── pubmed/server.json               # 官方 MCP Registry 元数据
├── clinical-trials/server.json
├── open-payments/server.json
├── hcp/server.json
├── sec-ownership/server.json
├── sec-filings/server.json
├── provider-market/server.json
└── reimbursement/server.json

克隆此仓库会下载分发元数据。它不会下载证据语料库或启动本地服务器；这些清单将兼容的客户端连接到 Academica 的托管端点。

安全与政策

- 切勿提交运营 API 密钥。
- 将 ACADEMICA_API_KEY 存储在客户端环境或其受保护的凭证存储中。
- 在 API 密钥控制台撤销已暴露或未使用的密钥。
- 将安全问题私下报告至 sid@academica.sh。

隐私政策 · 条款 · MIT 许可证

Academica
面向 AI 智能体的科学证据基础设施
academica.sh