mcp-openfda
Query OpenFDA drug-label data and perform drug-safety retrieval/analysis from FDA label content.
Search FDA drug labels with OpenFDA query expressions, pagination (
skip/limit), and field-based counts (count).Retrieve adverse reactions for a drug by name.
Retrieve warnings and precautions for a drug by name.
Retrieve indications and usage information for a drug by name.
Run an advanced RAG pipeline to fetch, extract, chunk, retrieve, and summarize label data for a drug/query/condition, returning top relevant chunks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-openfda show me the warnings for ibuprofen"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
OpenFDA Drug Label MCP Server
让 AI 助手检索 FDA 药品标签、提取安全信息与适应症、获取完整标签,并按字段统计检索结果。
English · API · GitHub Issues
功能特性
search_drug_labels:搜索药品标签,支持 openFDA 查询表达式、分页和字段统计;返回完整标签或 term/count 统计桶。get_drug_adverse_reactions:按通用名、商品名或成分名获取不良反应及禁忌原文,保留标签标识。get_drug_warnings:获取警告、注意事项、warnings_and_cautions 和黑框警告原文。get_drug_indications:获取适应症、用途及用法用量原文。get_drug_details:按 set_id 获取生效日期最新的一条完整标签;可选择顶层字段,正文不截断。search_labels:按药物名称和可选不良反应关键词检索四类安全章节。
Related MCP server: openfda-mcp-server
快速开始
需要 Git、Node.js 22 或更高版本及 npm,并能访问 api.fda.gov。
git clone https://github.com/Aki894/mcp-openfda.git
cd mcp-openfda
npm ci
npm run build配置 MCP 客户端
在支持 mcpServers 配置格式的客户端中加入以下条目,将入口替换为构建后的绝对路径:
{
"mcpServers": {
"openfda": {
"command": "node",
"args": [
"/absolute/path/to/mcp-openfda/dist/index.js"
]
}
}
}Windows 可使用 D:/mcp/mcp-openfda/dist/index.js,避免 JSON 反斜杠转义。若客户端找不到 node,将 command 改为 Node.js 可执行文件的绝对路径。保存后重新加载 MCP 连接,检查工具列表。其他客户端请按其格式填写相同的命令与参数。
服务器使用 stdio,由 MCP 客户端启动,无需端口或 HTTP 地址。直接在终端启动后等待标准输入属于正常行为。
可选 API 密钥
可以不配置密钥试用。经常使用时建议申请 openFDA API 密钥,在服务器条目中加入:
{"env": {"OPENFDA_API_KEY": "YOUR_OPENFDA_API_KEY"}}这是服务器条目的附加字段,不是独立的完整客户端配置。密钥通过 HTTP Basic Authentication 发送,不加入返回的查询 URL。配额以官方文档为准。
可用工具
当前提供 6 个工具。参数使用严格校验,拒绝未声明字段;字符串会去除首尾空格并拒绝控制字符。数字参数使用 JSON 数字,布尔参数使用 JSON 布尔值。下表的默认值、必填项和边界与服务实际公布的 schema 一致。
search_drug_labels
搜索药品标签,支持 openFDA 查询表达式、分页和字段统计;返回完整标签或 term/count 统计桶。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 否 |
| openFDA 查询表达式,可包含字段名和布尔条件。 长度为 1–4000 个字符 |
| string | 否 |
| 统计字段,例如 openfda.manufacturer_name.exact。 长度为 1–200 个字符 |
| integer | 否 |
| 跳过记录数,用于分页;统计查询须为 0。 ≥0; ≤25000 |
| integer | 否 |
| 本次最多返回的记录或统计桶数量。 ≥1; ≤1000 |
调用示例(MCP tools/call 的参数):
{
"name": "search_drug_labels",
"arguments": {
"search": "openfda.generic_name:aspirin",
"limit": 3
}
}get_drug_adverse_reactions
按通用名、商品名或成分名获取不良反应及禁忌原文,保留标签标识。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 是 |
| 英文药物通用名、商品名或成分名。 长度为 1–200 个字符 |
| integer | 否 |
| 本次最多返回的记录或统计桶数量。 ≥1; ≤50 |
调用示例(MCP tools/call 的参数):
{
"name": "get_drug_adverse_reactions",
"arguments": {
"drug_name": "ibuprofen",
"limit": 3
}
}get_drug_warnings
获取警告、注意事项、warnings_and_cautions 和黑框警告原文。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 是 |
| 英文药物通用名、商品名或成分名。 长度为 1–200 个字符 |
| integer | 否 |
| 本次最多返回的记录或统计桶数量。 ≥1; ≤50 |
调用示例(MCP tools/call 的参数):
{
"name": "get_drug_warnings",
"arguments": {
"drug_name": "ibuprofen",
"limit": 3
}
}get_drug_indications
获取适应症、用途及用法用量原文。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 是 |
| 英文药物通用名、商品名或成分名。 长度为 1–200 个字符 |
| integer | 否 |
| 本次最多返回的记录或统计桶数量。 ≥1; ≤50 |
调用示例(MCP tools/call 的参数):
{
"name": "get_drug_indications",
"arguments": {
"drug_name": "aspirin",
"limit": 3
}
}get_drug_details
按 set_id 获取生效日期最新的一条完整标签;可选择顶层字段,正文不截断。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 是 |
| 检索结果中的标签集合 UUID。 |
| string[] | 否 |
| 返回字段列表,省略或空数组表示全部。 maxItems=50 |
调用示例(MCP tools/call 的参数):
{
"name": "get_drug_details",
"arguments": {
"set_id": "0058175f-3474-40c3-a046-6cfaec86d84b",
"fields": [
"indications_and_usage",
"warnings"
]
}
}search_labels
按药物名称和可选不良反应关键词检索四类安全章节。
参数 | 类型 | 必填 | 默认值 | 描述与范围 |
| string | 是 |
| 英文药物名称。 长度为 1–200 个字符 |
| string | 否 |
| 可选不良反应搜索词。 长度为 1–200 个字符 |
| integer | 否 |
| 本次最多返回的记录或统计桶数量。 ≥1; ≤20 |
调用示例(MCP tools/call 的参数):
{
"name": "search_labels",
"arguments": {
"drug": "ibuprofen",
"adr": "bleeding",
"limit": 3
}
}返回结果与查询行为
MCP 响应的 content 中包含一个 type: "text" 项,其 text 是 JSON 字符串。所有成功结果均包含 source 和 query_url,分别标明数据源和主查询 URL。复合工具的其他请求链接在结果内保留。
工具 | 数据字段与行为 |
|
|
三个章节工具 |
|
|
|
|
|
搜索和章节工具无结果时返回空数组。缺失章节不补造内容。标签条数不等于不同药物的数量,同一药物可有不同厂商和版本。普通检索的 meta.results 提供上游的 total、skip 和 limit;统计查询的元数据结构由上游决定。
drug_name 查询通用名、商品名或成分名;search_labels.drug 查询通用名或商品名,adr 仅筛选 adverse_reactions 字段。名称值会加引号,输入中的双引号和反斜杠替换为空格;search_drug_labels.search 则直接使用 openFDA 查询语法。count 与非零 skip 不可同时使用。fields 省略或为空数组时返回完整标签;未存在的指定字段会跳过。
使用示例
连接后可以向助手提出:
检索 ibuprofen 的警告和不良反应,保留标签来源;再用结果中的 set_id 获取完整标签。
返回信息用于检索与研究辅助;临床判断需结合具体产品、研究设计和个人情况,本项目不提供个人诊疗建议。
数据来源
每次调用访问官方 GET https://api.fda.gov/drug/label.json。此项目检索药品标签,未查询 FAERS 个例报告。没有本地标签数据库或结果缓存。请参阅 字段参考和 openFDA 使用条款。
错误处理与故障排查
工具执行失败时返回 isError: true,文本 JSON 结构如下:
{"error":{"code":"invalid_arguments","message":"…","retryable":false}}每次上游请求默认超时 30 秒,不自动重试;复合工具可能执行多次请求。retryable 提示调用方稍后是否适合重试。
情况 / 错误码 | 处理方法 |
工具缺失或连接关闭 | 确认 Node.js ≥22,执行构建,检查绝对路径,并重新加载客户端。 |
| 检查必填项、类型、范围及枚举,删除额外参数。 |
| 重新加载工具列表并使用上文工具名。 |
| 检查服务器能否访问 api.fda.gov,稍后重试。 |
| 降低请求频率,等待上游恢复。 |
| 检查查询表达式、凭据及上游访问条件。 |
| 检查记录标识;搜索无匹配按各工具的空结果规则处理。 |
| 上游响应格式异常,持续出现时附错误码提交 Issue。 |
| 客户端取消了请求,需要时重新发起。 |
| 检查安装与本地改动,附运行环境和错误信息反馈。 |
从源码运行
npm run build
npm start
npm run dev上述命令分别用于构建、启动构建产物和直接运行 TypeScript 源码。
反馈与许可证
通过 GitHub Issues 反馈问题,请提供 Node.js 版本、MCP 客户端、工具参数及错误码,移除密钥和个人信息。
代码采用 GPL-3.0。数据来源条款单独适用。
Available Tools
5 toolsae_pipeline_ragC
Advanced RAG pipeline for drug safety analysis. Fetches, extracts, chunks, retrieves and summarizes FDA drug label data in one call to prevent LLM response truncation.
Inputs: drug, query, top_k, filters, +1 more.
get_drug_adverse_reactionsB
Get adverse reactions information for a specific drug from FDA labels
Inputs: drug_name (required), limit.
get_drug_indicationsA
Get indications and usage information for a specific drug from FDA labels
Inputs: drug_name (required), limit.
get_drug_warningsC
Get warnings and precautions for a specific drug from FDA labels
Inputs: drug_name (required), limit.
search_drug_labelsB
Search FDA drug labels using OpenFDA API. Returns drug labeling information including indications, contraindications, warnings, and adverse reactions.
Inputs: skip, count, limit, search.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools have clear, distinct purposes: get_drug_adverse_reactions, get_drug_warnings, and get_drug_indications target specific label sections, while search_drug_labels provides broad search. However, search_drug_labels overlaps with the section-specific tools, and ae_pipeline_rag also covers drug label data, creating minor ambiguity.
Three tools follow a consistent get_drug_<section> pattern (get_drug_adverse_reactions, get_drug_warnings, get_drug_indications), but search_drug_labels and ae_pipeline_rag deviate from this pattern. The convention is mostly consistent, with two outliers.
Five tools is well-scoped for a focused FDA drug label API server. Each tool serves a clear purpose without unnecessary bloat, making the count appropriate.
The set covers common drug label sections (indications, warnings, adverse reactions) and provides search and RAG capabilities, but omits other important sections like contraindications, dosage, or interactions. There's no direct tool for retrieving the full label, which is a notable gap.
Maintenance
Related MCP Connectors
Search and export FDA drug labels by brand name, generic ingredient, or UNII code.
Search DailyMed drug labels, SPLs, NDCs and packaging.
Test healthcare AI agents' medication claims against cited FDA label text. Not for clinical use.
Official FDA recalls, drug labels, adverse events and clinical trials, with cited sources.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to the official FDA DailyMed database for comprehensive drug information, including drug labels, NDC codes, RxNorm mappings, pharmacologic classifications, and FDA application numbers through natural language queries.283MIT
- AlicenseAqualityDmaintenanceEnables LLMs to search FDA drug labels and adverse event data via the OpenFDA API, supporting natural language queries for drug safety information.2MIT
- AlicenseAqualityDmaintenanceEnables querying FDA drug label information including adverse reactions, warnings, and indications via natural language.54 npm1GPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables querying FDA medical device regulatory databases including 510(k) clearances, PMA approvals, recalls, and adverse events through natural language.102 npmMIT