🚀 OpenFDA MCP 服务器
这是一个模型上下文协议（MCP）服务器，用于从 OpenFDA API 查询药品信息。通过该服务器，用户可以方便地获取各类药品的详细信息，为药品相关的研究和应用提供有力支持。
✨ 主要特性
- 按品牌名称检索药品标签信息
- 按通用名（活性成分）检索药品信息
- 获取通用药品的所有品牌版本
- 获取药品（按品牌或通用名）的不良事件（副作用）报告
- 检索特定公司生产的所有药品
- 获取全面的药品安全信息（警告、禁忌、相互作用、预防措施等）
- 规范和验证国家药品代码（NDC）格式
- 为查询失败提供有用的错误消息和建议
📦 安装指南
1. 设置 OpenFDA API 密钥
MCP 服务器需要 OpenFDA API 密钥才能访问 OpenFDA API。在项目根目录下创建一个 .env 文件，并添加以下行：
OPENFDA_API_KEY=your_openfda_api_key_here
⚠️ 重要提示
切勿将真实的 API 密钥提交到版本控制中。你可以从 OpenFDA API 密钥注册 获取 API 密钥。
2. 示例 MCP 服务器配置
如果你要将此服务器与更大的 MCP 系统集成，配置可能如下所示：
{
"mcpServers": {
"openfda": {
"command": "npx",
"args": ["@ythalorossy/openfda"],
"env": {
"OPENFDA_API_KEY": "************"
},
"timeout": 60000
}
}
}
将星号替换为你实际的 API 密钥，或者确保从 .env 文件中加载它。
本地运行
git clone https://github.com/ythalorossy/openfda.git
cd openfda
npm install
💻 使用示例
基础用法
首先，构建项目：
npm run build
然后，从构建文件夹启动服务器：
node build/index.js
💡 使用建议
- 构建步骤 (
npm run build) 会将源文件编译到build/目录中。- 除非项目设置为直接从源文件运行，否则应运行编译后的输出（例如
build/bin/index.js），而不是源文件 (bin/index.js)。
📚 详细文档
创建一个 .env 文件来存储所需的环境变量。
📄 许可证
本项目采用 MIT 许可证。
