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 devHTTP服务器模式（用于云运行）
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的使用示例。
许可证
麻省理工学院