内容
[_2026-Forever_Healthy-573D7D.svg)](https://forever-healthy.org)
[](https://www.npmjs.com/package/evipedia-mcp)
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.forever-healthy/evipedia-mcp)
# Evipedia MCP 服务器
一个小型 [模型上下文协议](https://modelcontextprotocol.io) 服务器，允许 AI 代理查询 [evipedia.ai](https://evipedia.ai) — 我们不断更新的健康和长寿干预措施证据评论百科全书 — 并建议新的干预措施进行审查。
## 工具
* `search_reviews(query)` → 匹配的评论（名称/同义词/关键词/类别），每个评论都有其 URL 和结论
* `list_reviews()` → 完整的目录，以 `{topic, slug}` 对的形式呈现（规范主题 + 您传递给 `get_review`/`get_conclusion` 的 slug）
* `get_conclusion(slug|url)` → 只是评论的纯文本结论
* `get_review(slug|url)` → 完整的评论，以原始 Markdown 格式呈现
* `get_metadata(slug|url)` → 结构化的医学元数据，以 JSON 格式呈现 — 评论日期（`datePublished`/`dateModified`/`lastReviewed`，一个不在 Markdown 中的新鲜度信号），类型化的 `about` 实体，带有备用名称，以及带有 PubMed PMID 的有序 `citation` 列表
读取工具接受裸 slug（例如 `rapamycin`）或完整的 evipedia.ai URL（例如 `https://evipedia.ai/rapamycin`）— URL 的最后一个路径段是 slug，因此搜索结果的 URL 可以直接传递。
* `suggest_intervention(intervention, goal?, references?, email?)` → 向 evipedia 的公共建议表单提交新的干预措施（与 [evipedia.ai/suggest](https://evipedia.ai/suggest) 上的表单相同）
* `get_version()` → 运行服务器的包名称和版本
## 安装（本地或远程）
服务器以 **[`evipedia-mcp`](https://www.npmjs.com/package/evipedia-mcp)** 的形式发布到 npm，并通过 `npx` 在标准输入/输出上运行 — 无需全局安装。它也列在 [官方 MCP 注册表](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.forever-healthy/evipedia-mcp) 中，作为 **`io.github.forever-healthy/evipedia-mcp`**，因此支持 MCP 的客户端可以自动发现并安装它。
客户端配置：本地 MCP（需要 Node.js ≥ 18）
```json
{
"mcpServers": {
"evipedia": {
"command": "npx",
"args": ["-y", "evipedia-mcp"]
}
}
}
```
对于无法或不希望进行本地安装的环境，我们还在 [`https://mcp.evipedia.ai/`](https://mcp.evipedia.ai/) 上提供了一个托管的 MCP 服务器，可以通过 HTTP 使用。
客户端配置：通过 HTTP 的远程 MCP
```json
{
"mcpServers": {
"evipedia": {
"type": "http",
"url": "https://mcp.evipedia.ai/mcp"
}
}
}
```
- **Claude 代码** — 添加到项目的 `.mcp.json` 中（或运行 `claude mcp add`）。
- **Claude 桌面版** — 添加到 `claude_desktop_config.json` 中。
- **Cursor** — 添加到 MCP 设置中。
## 试用
您可以使用捆绑的 **`/demo`** 技能来测试各自的连接。
它遍历读取工具（`get_version`、`search_reviews`、`list_reviews`、`get_review`、`get_conclusion`、`get_metadata`），针对实时 evipedia.ai 数据。
## 架构
服务器是一个 **仅使用 evipedia.ai 公共端点的薄客户端**。它不依赖于 evipedia 内容存储库 — 公共表面是 API 设计的。
* 从 `https://evipedia.ai` 获取实时数据，带有小型的进程内缓存（两个 JSON 索引都很小）
* 大多数为只读，无需身份验证。唯一的写入路径是 `suggest_intervention`，它将数据发布到 evipedia 的公共建议表单（Formspree）
### 公共 API 接口
基准 URL：`https://evipedia.ai`
| 端点 | 描述 |
|---|---|
| `GET /reviews.json` | 完整目录：`canonical_name`、`alternate_names[]`、`permalink`、`permalink_md`、`permalink_meta`、`category`、`creation_date`、`dateModified`、`lastReviewed`、`er_conclusion` |
| `GET /search.json` | 搜索索引：`short_topic`、`alternate_names`、`ep_keywords`、`ep_category`、`url` |
| `GET /{permalink}.md` | 完整的评论，以原始 Markdown 格式呈现（前言 + 正文） |
| `GET /{permalink}.meta.json` | 扁平化的医学元数据：`slug`、`topic`、`url`、`datePublished`/`dateModified`/`lastReviewed`、`about`（`type`/`name`/`alternateName`）、有序 `citation[]`（`name`、`url`、`pmid?`） |
| `GET /llms.txt` | 代理/人工标志 — 包括稳定的章节锚点列表 |
| `GET /sitemap.xml` | 规范的评论 URL |
| `GET /feed.xml` | 最新更新的 RSS 源 |
