RxNav MCP Server
RxNav MCP Server
一个用于查询RxNav API的MCP(Model Context Protocol)服务器,专为药物术语标准化和药名归一化设计。
功能特性
药物名称搜索: 通过药物名称搜索获取RxNorm标准化信息
通用名转换: 实现商品名与通用名的相互转换
ATC分类查询: 获取药物的ATC分类代码和层级信息
成分查询: 获取药物的活性成分信息
Related MCP server: mcp-dailymed
可用工具
1. search_drug_by_name
通过药物名称搜索RxNorm概念信息。
参数:
drug_name(string, 必需): 药物名称limit(number): 返回记录数限制 (1-50)
2. get_generic_name
获取药物的通用名信息。
参数:
drug_name(string, 必需): 药物名称或RxCUI
3. get_brand_names
获取通用名对应的商品名列表。
参数:
generic_name(string, 必需): 通用名
4. get_atc_classification
获取药物的ATC分类代码。
参数:
drug_identifier(string, 必需): 药物名称或RxCUI
5. get_drug_ingredients
获取药物的活性成分信息。
参数:
drug_identifier(string, 必需): 药物名称或RxCUI
安装和运行
本地开发
# 安装依赖
npm install
# 开发模式运行
npm run dev
# 构建
npm run build
# 生产模式运行
npm startUbuntu服务器部署
1. 环境准备
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version2. 部署MCP服务器
# 创建项目目录
mkdir -p ~/mcp-servers/rxnav
cd ~/mcp-servers/rxnav
# 上传项目文件(使用scp或git clone)
# 方法1: 使用git
git clone <your-repo-url> .
# 方法2: 使用scp从本地上传
# scp -r /path/to/mcp-rxnav/* user@your-server:~/mcp-servers/rxnav/
# 安装依赖
npm install
# 构建项目
npm run build
# 测试运行
npm start3. 使用PM2管理进程(推荐)
# 全局安装PM2
sudo npm install -g pm2
# 创建PM2配置文件
cat > ecosystem.config.js << 'EOF'
module.exports = {
apps: [{
name: 'mcp-rxnav',
script: 'dist/index.js',
cwd: '/home/ubuntu/mcp-servers/rxnav',
instances: 1,
autorestart: true,
watch: false,
max_memory_restart: '1G',
env: {
NODE_ENV: 'production'
}
}]
}
EOF
# 启动服务
pm2 start ecosystem.config.js
# 设置开机自启
pm2 startup
pm2 save
# 查看状态
pm2 status
pm2 logs mcp-rxnav4. 配置防火墙(如果需要网络访问)
# 如果需要通过网络访问,可以配置nginx反向代理
sudo apt install nginx
# 创建nginx配置
sudo tee /etc/nginx/sites-available/mcp-rxnav << 'EOF'
server {
listen 80;
server_name your-domain.com; # 替换为你的域名或IP
location / {
proxy_pass http://localhost:3000; # 如果MCP服务器监听3000端口
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
}
EOF
# 启用站点
sudo ln -s /etc/nginx/sites-available/mcp-rxnav /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx远程调用配置
方法1: 通过SSH隧道
在客户端机器上创建SSH隧道:
# 创建SSH隧道,将本地端口转发到服务器
ssh -L 3000:localhost:3000 user@your-server-ip
# 然后在MCP客户端配置中使用 localhost:3000方法2: 网络MCP服务器
如果需要通过网络直接访问,需要修改MCP服务器以支持网络传输:
// 在src/index.ts中添加网络传输支持
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
// 替换stdio传输为网络传输
const transport = new SSEServerTransport("/message", response);方法3: 使用Docker部署
# 创建Dockerfile
cat > Dockerfile << 'EOF'
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
COPY src/ ./src/
EXPOSE 3000
CMD ["npm", "start"]
EOF
# 构建和运行
docker build -t mcp-openfda .
docker run -d -p 3000:3000 --name mcp-openfda-server mcp-openfda使用示例
在Claude Desktop中配置
在Claude Desktop的配置文件中添加:
{
"mcpServers": {
"rxnav": {
"command": "node",
"args": ["/path/to/mcp-rxnav/dist/index.js"],
"env": {}
}
}
}远程服务器配置
{
"mcpServers": {
"rxnav": {
"command": "ssh",
"args": [
"user@your-server-ip",
"cd ~/mcp-servers/rxnav && node dist/index.js"
],
"env": {}
}
}
}测试和示例
运行集成测试
# 构建项目
npm run build
# 运行集成测试
node test/integration.test.js运行使用示例
# 运行使用示例
node examples/usage-examples.jsAPI使用示例
1. 药物名称搜索
// 搜索阿司匹林的信息
const result = await search_drug_by_name({
drug_name: "aspirin",
limit: 5
});
// 返回结果示例:
{
"query": "aspirin",
"drugs": [
{
"rxcui": "1191",
"name": "Aspirin",
"termType": "IN"
},
{
"rxcui": "243670",
"name": "Aspirin 325 MG Oral Tablet",
"termType": "SCD"
}
],
"total_found": 2
}2. 通用名转换
// 获取Advil的通用名
const result = await get_generic_name({
drug_identifier: "Advil"
});
// 返回结果示例:
{
"query": "Advil",
"rxcui": "5640",
"generic_names": [
{
"rxcui": "5640",
"name": "ibuprofen",
"termType": "IN"
}
],
"total_found": 1
}3. 商品名查询
// 查询布洛芬的商品名
const result = await get_brand_names({
generic_name: "ibuprofen"
});
// 返回结果示例:
{
"query": "ibuprofen",
"generic_rxcui": "5640",
"brand_names": [
{
"rxcui": "209387",
"name": "Advil",
"termType": "BN"
},
{
"rxcui": "209459",
"name": "Motrin",
"termType": "BN"
}
],
"total_found": 2
}4. ATC分类查询
// 获取阿司匹林的ATC分类
const result = await get_atc_classification({
drug_identifier: "aspirin"
});
// 返回结果示例:
{
"query": "aspirin",
"rxcui": "1191",
"atc_codes": [
{
"code": "N02BA01",
"level": 5,
"name": "Chemical substance"
},
{
"code": "B01AC06",
"level": 5,
"name": "Chemical substance"
}
],
"total_found": 2
}5. 药物成分查询
// 查询泰诺的活性成分
const result = await get_drug_ingredients({
drug_identifier: "Tylenol"
});
// 返回结果示例:
{
"query": "Tylenol",
"rxcui": "202433",
"ingredients": [
{
"rxcui": "161",
"name": "acetaminophen",
"termType": "IN"
}
],
"total_found": 1
}环境变量
RXNAV_DEBUG: 设置为true启用详细日志记录
注意事项
API限制: RxNav API有速率限制,建议合理控制请求频率
数据准确性: 返回的数据仅供参考,不应作为医疗建议
网络安全: 如果部署在公网,请确保适当的安全措施
日志监控: 建议配置日志监控以跟踪API使用情况
错误处理: 服务器包含完整的错误处理和重试机制
故障排除
常见问题
连接失败: 检查网络连接和防火墙设置
权限错误: 确保Node.js进程有适当的文件权限
端口冲突: 检查端口是否被其他服务占用
日志查看
# PM2日志
pm2 logs mcp-openfda
# 系统日志
sudo journalctl -u nginx -f许可证
MIT License
Available Tools
6 toolsae_pipeline_ragB
Advanced RAG pipeline for drug terminology analysis. Fetches, extracts, chunks, retrieves and summarizes RxNav drug terminology data in one call to prevent LLM response truncation.
Inputs: drug, query, top_k, filters, +1 more.
get_atc_classificationB
Get ATC (Anatomical Therapeutic Chemical) classification codes for a given drug name or RxCUI. Returns WHO ATC classification hierarchy information.
Inputs: drug_identifier (required).
get_brand_namesB
Get brand names for a given generic drug name. Returns all commercial brand names associated with the generic drug.
Inputs: generic_name (required).
get_drug_ingredientsA
Get active ingredients for a given drug name or RxCUI. Returns ingredient information including strength and dosage form details.
Inputs: drug_identifier (required).
get_generic_nameB
Get the generic name(s) for a given drug name or RxCUI. Converts brand names to their corresponding generic names.
Inputs: drug_identifier (required).
search_drug_by_nameB
Search for drug information by name using RxNav API. Returns RxNorm concept information including RXCUI and related drug details.
Inputs: drug_name (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Five lookup tools target distinct attributes (search, generic, brand, ATC, ingredients) with clear boundaries. The ae_pipeline_rag tool overlaps as a bulk RAG superset of those lookups, but its one-call summarization role is sufficiently differentiated.
Five tools use predictable snake_case verb_noun naming (search_drug_by_name, get_generic_name, get_brand_names, get_atc_classification, get_drug_ingredients). The final tool ae_pipeline_rag breaks the verb_noun pattern and uses a noun/prefix convention, a minor inconsistency.
Six tools is well-scoped for a drug terminology lookup server; each tool covers a distinct facet or workflow without bloat.
Covers name lookup, generic/brand conversion, ATC classification, ingredients, and a bulk RAG pipeline. Minor gaps remain for common RxNav operations like drug-drug interactions or related-concept expansion.
Maintenance
Related MCP Connectors
Look up drug names, RxCUIs, ingredients and interactions in RxNorm.
RxNorm MCP — wraps the NLM RxNav REST API (free, no auth)
Drug-drug interaction checker for clinical LLMs using RxNorm and DailyMed.
US medication lookup: drug search, forms and strengths, NDC/RxCUI, recalls, shortages.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to the official FDA DailyMed database for comprehensive drug information, including drug labels, NDC codes, RxNorm mappings, pharmacologic classifications, and FDA application numbers through natural language queries.283MIT
- AlicenseNot gradedqualityCmaintenanceSearch and retrieve FDA Structured Product Labels from DailyMed via NLM, supporting queries by drug name, NDC, RXCUI, and more.100 npmMIT
- AlicenseAqualityCmaintenanceEnables conversational drug and supplement lookup, detailed profiles, and interaction checking via the MedData API.729 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables users to query standardized drug concepts from the National Library of Medicine's RxNorm, including name-based search, drug property retrieval, and related concept exploration via the RxNav REST API.83 npmMIT