JinDaGe - openfda MCP Details

article

README

🚀 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 许可证。

请我喝杯咖啡

coff.ee/ythalorossy

openfda