临床试验搜索服务

Exmplr MCP Server是一个用于搜索临床试验和预览荟萃分析结果的模型上下文协议(MCP)服务器,适用于医疗研究领域。

  • by Exmplr-AI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Exmplr-AI/exmplr-mcp

使用说明

Exmplr MCP服务器

模型上下文协议(MCP)服务器,用于通过Exmplr平台搜索临床试验和预览荟萃分析结果。

特性

  • 只读访问 临床试验数据
  • 频率限制 (每个IP每分钟30个请求)
  • 缓存响应 (60秒TTL)
  • 5专用工具:
    • trials.search_preview -搜索多达5项临床试验
    • autocomplete.condition -自动完成医疗条件
    • autocomplete.location -自动完成试用地点
    • meta.preview -预览荟萃分析结果
    • exmplr.learn_more -获取公开的Exmplr营销URL

安装

npm install
npm run build

配置

复制 .env.example 到 .env 并设置您的API密钥:

cp .env.example .env

编辑 .env:

EXMPLR_API_KEY=your_api_key_here
BASE_URL=https://service-worker.exmplr.ai

跑步

开发模式(stdio)

npm run dev

HTTP服务器模式(用于云运行)

npm run dev:http

生产模式

npm run build
npm start           # stdio mode
npm start:http      # HTTP server mode

🚀 云运行部署

在5分钟内部署到Google Cloud Run:

# Set your project and API key
export PROJECT_ID=your-gcp-project-id
export EXMPLR_API_KEY=your_api_key

# Run automated deployment
./scripts/deploy.sh

文档:

您将获得:

  • ✅ HTTPS端点 /ping, /tools,和舱单
  • ✅ 自动缩放(缩放到零=0美元的闲置成本)
  • ✅ 99.95%的SLA与全球CDN
  • ✅ 内置监控和日志记录
  • ✅ 成本:典型使用情况下每月<5美元

与克劳德桌面、克劳德代码或光标一起使用

选项1:连接到远程服务器(推荐)

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上, %APPDATA%\Claude\claude_desktop_config.json 在Windows上):

{
  "mcpServers": {
    "exmplr": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.exmplr.ai/mcp"
      ]
    }
  }
}

对于Claude Code,请使用CLI:

claude mcp add-json exmplr '{"command":"npx","args":["mcp-remote","https://mcp.exmplr.ai/mcp"]}'

选项2:本地运行

克隆并构建此存储库,然后配置:

{
  "mcpServers": {
    "exmplr": {
      "command": "node",
      "args": ["/path/to/exmplr-mcp/dist/server.js"],
      "env": {
        "EXMPLR_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用Claude Web

Claude Web目前不支持通过清单URL远程MCP服务器。请改用Claude Desktop或Claude Code。

工具

trials.search_preview

使用过滤器搜索临床试验。最多返回5次试验。

输入:

{
  "query": "breast cancer",
  "overall_status": "Recruiting",
  "phase": "Phase 3",
  "country": "United States"
}

输出:

{
  "total": 142,
  "items": [
    {
      "nct_id": "NCT12345678",
      "title": "Study of Drug X in Breast Cancer",
      "phase": "Phase 3",
      "status": "Recruiting"
    }
  ]
}

自动补全条件

获取条件名称建议。

输入:

{
  "query": "diab"
}

输出:

{
  "suggestions": [
    "Diabetes Mellitus",
    "Diabetes Mellitus, Type 2",
    "Diabetic Neuropathy"
  ]
}

自动补全定位

获取试验的位置建议。

输入:

{
  "query": "New Y"
}

输出:

{
  "suggestions": [
    "New York, NY, USA",
    "New York, USA",
    "New Haven, CT, USA"
  ]
}

meta.preview

预览荟萃分析搜索结果。

输入:

{
  "query": "multiple sclerosis",
  "intervention": "rituximab"
}

输出:

{
  "total": 23,
  "examples": [
    "Rituximab in Progressive Multiple Sclerosis",
    "B-Cell Depletion in MS: A Meta-Analysis",
    "Efficacy of Rituximab in RRMS Patients"
  ]
}

exmplr.learn_more

获取带有UTM跟踪的公共Exmplr营销页面URL。

输入:

{
  "topic": "meta"
}

输出:

{
  "urls": [
    "https://exmplr.ai/pharma/meta-analysis?utm_source=mcp&utm_medium=claude&utm_campaign=exmplr_mcp"
  ],
  "note": "These are public marketing pages. No account or key required."
}

建筑

  • 没有深层链接:此服务器不提供指向后端UI的深度链接。这 exmplr.learn_more 该工具仅返回公共营销页面。
  • 服务器端身份验证:您的 EXMPLR_API_KEY 仅在服务器端使用,从不向客户端公开。
  • 速率限制:内置基于IP的速率限制(30个请求/分钟)。
  • 缓存:所有API响应缓存60秒,以减少后端负载。
  • 可流式HTTP传输:使用MCP stdio传输进行通信。

安全与隐私

  • 看 隐私.md 有关隐私的详细信息
  • 所有工具都是只读的
  • 未存储用户数据
  • API密钥基于环境,从不记录
  • 费率限制防止滥用

例子

看 示例.md 关于Claude的使用示例。

许可证

麻省理工学院