# 开发者

Mdexa 是医学 AI 可直接调用的生物医学数据库：通过 MCP 或 API 检索医学数据集，并获得带原文证据的许可结论。

## MCP

 地址 `https://mcp.mdexa.com/mcp` · Streamable HTTP。少量调用无需账号。

```
{ "mcpServers": { "mdexa": { "url": "https://mcp.mdexa.com/mcp" } } }
```

- `search_datasets` Search datasets
- `get_card` Get dataset card
- `get_license_evidence` Get license evidence
- `list_facets` List categories and filter values
- `get_overview` What Mdexa is and what it is worth
- `get_access` Get access method
- `find_similar_datasets` Find similar datasets
- `batch_check` Check a list of datasets
- `check_changes` What changed in a list of datasets
- `request_dataset` Ask for a dataset to be added or verified
- `search_content` Search dataset content (not open yet)

## HTTP API

 少量调用无需密钥。免费账号的密钥限额更高，能查看调用记录，并可用清单核对。密钥放在 `Authorization: Bearer <key>`请求头中。 [创建密钥](https://mdexa.com/zh/dashboard/#keys)

```
curl "https://mcp.mdexa.com/v1/datasets?content_type=benchmark-exam&language=zh&limit=2"
```

- `GET /v1/datasets`
- `GET /v1/datasets/{slug}`
- `GET /v1/datasets/{slug}/evidence`
- `GET /v1/datasets/{slug}/similar`
- `GET /v1/datasets/{slug}/access`
- `GET /v1/facets`
- `GET /v1/stats`
- `GET /v1/changelog`
- `GET /v1/overview`
- `GET /v1/content/search`
- `POST /v1/batch-check`
- `POST /v1/keys`
- `GET /v1/usage/summary`
- `GET /v1/admin/metrics`
- `GET /v1/tools`

 密钥带范围：数据集、内容检索、清单核对（模型服务已预留）。超出范围的调用返回 403 scope_denied，MCP 为错误码 4030。

## 文件

- [给 Agent 的说明](https://mdexa.com/zh/agents/)
- [agents.md](https://mdexa.com/zh/agents.md)
- [llms.txt](https://mdexa.com/llms.txt)
- [catalog.json](https://mdexa.com/catalog.json)
- [changelog.json](https://mdexa.com/changelog.json)
- [feed.xml](https://mdexa.com/feed.xml)

## 调用的计数口径

一次“调用”指机器对 Mdexa 数据库内容的一次读取：对 HTTP 接口数据端点的一次请求，一次查询数据库的 MCP 工具调用（search_datasets、get_card、get_license_evidence、list_facets、get_access、find_similar_datasets、batch_check、check_changes），或一次下载某个数据集的 .json 或 .md 文件（含用 Accept: text/markdown 取得的数据集页面）或整库文件 catalog.json。一次请求计一次。给人看的网页（HTML 及其样式、脚本、图片），说明性文件 llms.txt、llms-full.txt、agents.md，sitemap、订阅源、robots.txt，登录与账号请求、会话状态检查、MCP 的 initialize 与 tools/list、健康检查都不是调用，也不占用调用额度。只有实际执行的数据库查询才计入：被拒绝的请求（参数无效、一次超过 50 个 slug、数据集不存在、缺少或无效的密钥、工具返回错误、尚未开通的 search_content）不占用调用额度，另走单独的防滥用限流。 [FAQ](https://mdexa.com/zh/developers/faq/#call-definition)

 地址为上线前的示例值。 · [开发者 FAQ](https://mdexa.com/zh/developers/faq/)