OFFX MCP Server

基本能力

产品定位

OFFX MCP Server 是一个专门用于搜索和检索药物安全数据的服务，主要服务于医药研发和安全监测领域。

核心功能

• 直接访问 OFFX (Target Safety) 药物和安全数据库
• 支持通过药物、不良事件、目标、动作或名称进行搜索
• 检索药物的警报和分数
• 提供结构化 JSON 响应
• 支持大结果集的分页

适用场景

• 医药研发中的药物安全监测
• 不良事件的数据分析和检索
• 药物目标和动作的研究
• 药物安全评分和警报的获取

工具列表

1. search_drugs：通过名称搜索药物
2. get_drugs：通过目标 ID 和动作 ID 或不良事件 ID 获取药物
3. get_alerts：获取药物的警报
4. get_score：获取药物的分数
5. get_drug：通过药物 ID 获取药物主视图
6. search_adverse_events：通过名称搜索不良事件
7. get_adverse_events：通过药物 ID 或目标 ID 获取不良事件
8. search_targets：通过目标名称搜索目标
9. get_target：通过目标 ID 和动作 ID 获取目标主视图
10. get_targets：获取药物的主要或次要目标

常见问题解答

• 需要有效的 OFFX API 凭证才能使用服务
• 所有端点都接受 POST 请求和 JSON 主体
• 支持多种过滤参数，如不良事件 ID、警报类型、警报阶段等

使用教程

使用依赖

确保已安装 Node.js，以便使用 npx 命令。

安装教程

# 使用 npm 安装
npm install @uh-joan/offx-mcp-server

调试方式

1. 设置环境变量：

OFFX_API_TOKEN=your_offx_api_token
USE_HTTP=true  # 可选：作为 HTTP 服务器运行
PORT=3000      # 可选：指定 HTTP 服务器的端口

1. 运行服务器：

# 作为 MCP 服务器运行
npx offx-mcp-server

# 作为 HTTP 服务器运行
USE_HTTP=true PORT=3000 npx offx-mcp-server

在 Claude Desktop 上安装

1. 前往：Settings > Developer > Edit Config
2. 在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "offx": {
      "command": "npx",
      "args": [
        "-y",
        "@uh-joan/offx-mcp-server"
      ],
      "env": {
        "OFFX_API_TOKEN": "your_offx_api_token"
      }
    }
  }
}

1. 重启 Claude Desktop 并开始探索药物安全数据。

开发构建

git clone https://github.com/uh-joan/offx-mcp-server.git
cd offx-mcp-server
npm install
npm run build

本地开发

# 复制示例环境文件
cp .env.example .env

# 编辑 .env 文件，添加您的凭证
vim .env  # 或使用您喜欢的编辑器

# 启动服务器
npm run start

Docker

docker build -t offx-mcp-server .
docker run -i --env-file .env offx-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。