药物福利计划（PBS）MCP AI启用API服务器
一个独立的模型上下文协议（MCP）服务器，用于访问澳大利亚药品福利计划（PBS）API。
关于作者
这个PBS MCP服务器是由\[Mathow Cage\]开发的，他是https://ai-advantage.au，自动化、人工智能工程、人工智能集成和医疗数据系统专家。
与我合作： https://www.linkedin.com/in/digitalmarketingstrategyexpert/
概述
该项目提供了一个独立的MCP服务器，允许人工智能模型访问澳大利亚药品福利计划（PBS）API，其中包含有关澳大利亚药品、定价和供应的信息。
该项目是为公共API构建的，但如果您被授予开发人员访问权限，则可以很容易地适应私有API。
PBS API提供对PBS数据的编程访问，包括药品列表、定价和可用性。此MCP服务器可以轻松地将PBS数据集成到AI工作流中。
MCP可通过HTTP和CLI访问。
*请注意PBS的费率限制，并调整您的请求频率。我建议定期调用以存储您从API需要的信息，并每周更新一次。*
MCP服务器功能
此MCP服务器实现了以下模型上下文协议功能：
- 工具：提供用于查询PBS API端点的工具，允许人工智能模型访问药物数据
- 传输层：支持stdio和HTTP/SSE传输层
- 错误处理：针对API速率限制和身份验证问题的全面错误处理
- LLM集成：直接从LLM组件接收工具调用和提示，实现与PBS数据的无缝AI交互
运作原理
MCP客户端 :
- 接收工具调用：当LLM（如Claude）需要药品数据时，它会向此服务器发送工具调用
- 流程提示：解释有关药物信息的自然语言提示
- 执行API查询：将请求转换为适当的PBS API调用
- 返回结构化数据：发回LLM可以在其响应中使用的格式化药品数据
这使得AI助手能够访问最新的PBS信息，而无需在训练中使用这些数据。
安装
- 克隆此存储库：
git clone
cd pbs-mcp-standalone- 安装依赖项：
npm install- 构建项目：
npm run build用法
启动服务器
PBS MCP服务器可以在不同模式下运行：
标准模式（默认）
此模式与MCP协议兼容，并通过标准输入/输出流进行通信：
npm start或者使用提供的启动脚本：
./start.sh支持SSE的HTTP模式
此模式启动支持服务器发送事件（SSE）的HTTP服务器：
npm run start:http或者使用提供的启动脚本：
./start.sh http 3000哪里 3000 是要监听的端口号。
命令行界面
PBS MCP服务器也可以用作命令行工具：
npm run cli -- 或者使用提供的启动脚本：
./start.sh cli 例如：
./start.sh cli info用作命令行工具
要将此MCP服务器用作命令行工具：
- 构建项目：
npm run build- 使用所需命令运行CLI：
npm run cli -- 或者使用启动脚本：
./start.sh cli 与MCP客户端集成
此服务器可以与任何兼容MCP的客户端集成，例如：
- 本地AI编辑器和AI/LLM服务器
- 支持模型上下文协议的其他AI助手
- 使用MCP客户端库的自定义应用程序
客户端配置示例
以下是一个如何使用MCP客户端配置此服务器的示例：
{
"mcpServers": {
"pbs-api": {
"command": "node",
"args": ["path/to/pbs-mcp-standalone/build/index.js"],
"env": {
"PBS_API_SUBSCRIPTION_KEY": "your-subscription-key-here"
}
}
}
}从客户端访问服务器
要从客户端访问此MCP服务器：
- 适用于Claude Desktop或其他兼容MCP的AI助手:
- 配置助手以将此服务器用作MCP工具提供程序 - 助手将自动发现并使用此服务器提供的工具 - LLM可以发送关于将由服务器处理的药物的自然语言提示
- 用于自定义应用程序:
- 使用下面描述的HTTP API端点 - 连接到SSE端点以进行实时工具事件 - 或者生成服务器进程并通过stdin/stdout进行通信
LLM提示示例
服务器可以解释来自LLM的各种提示，例如：
"Find information about metformin in the PBS"
"What is the PBS code for insulin?"
"List all prescribers who can prescribe antibiotics"
"Get the latest pricing for asthma medications"这些自然语言提示被翻译成适当的PBS API调用。
API工具参数
PBS API工具可与以下参数一起使用：
{
"endpoint": "prescribers",
"method": "GET",
"params": {
"get_latest_schedule_only": "true",
"limit": "20"
}
}参数
endpoint（字符串，必需）：要访问的特定PBS API端点（例如，“处方医生”、“项目概览”）method（字符串，可选）：要使用的HTTP方法（建议对大多数PBS API操作使用GET）。默认值：“GET”params（object，可选）：查询请求中包含的参数subscriptionKey（字符串，可选）：自定义订阅密钥。如果没有提供，将使用默认公钥timeout（number，可选）：请求超时（毫秒）。默认值：30000
HTTP API
在HTTP模式下运行时，以下端点可用：
健康检查
GET /health返回服务器的状态。
列出工具
GET /tools返回可用工具的列表。
SSE端点
GET /sse建立SSE连接并发送工具事件。
工具调用（SSE）
POST /sse/:toolName调用工具并通过SSE发送结果。
工具调用（REST）
POST /api/:toolName调用一个工具并返回JSON格式的结果。
命令行界面
PBS MCP服务器可以用作具有以下命令的命令行工具：
列出端点
./start.sh cli list-endpoints列出所有可用的PBS API端点。
获取API信息
./start.sh cli info返回有关PBS API的信息。
查询处方者
./start.sh cli prescribers [options]选项：
-l, --limit：每页结果数（默认值：10）-p, --page：页码（默认值：1）-c, --pbs-code：按PBS代码过滤-s, --schedule-code：按计划代码筛选-t, --prescriber-type：按处方者类型筛选-f, --fields：要返回的特定字段--latest：只获取最新时间表
查询项目概述
./start.sh cli item-overview [options]选项：
-l, --limit：每页结果数（默认值：10）-p, --page：页码（默认值：1）-s, --schedule-code：按计划代码筛选-f, --fields：要返回的特定字段--latest：只获取最新时间表
查询任意端点
./start.sh cli query [options]选项：
-m, --method：HTTP方法（默认值：GET）-p, --params：以JSON字符串形式查询参数-k, --subscription-key：自定义订阅密钥-t, --timeout：请求超时（毫秒）
启动HTTP服务器
./start.sh cli serve [options]选项：
-p, --port：要监听的端口（默认值：3000）
可用端点
PBS API为访问不同类型的数据提供了几个端点：
/-根端点，提供API信息和变更日志/prescribers-处方医生信息/item-overview-PBS项目的详细信息/items-PBS项目的基本信息/schedules-PBS时间表信息/atc-codes-解剖治疗化学（ATC）分类代码/organisations-关于组织的信息/restrictions-关于限制的信息/parameters-参数信息/criteria-关于标准的信息/copayments-关于共付额的信息/fees-费用信息/markup-bands-关于标记带的信息/programs-项目信息/summary-of-changes-变更摘要
有关端点的完整列表，请参阅 PBS API文件.
示例用法
获取API信息
{
"endpoint": ""
}获取处方医生
{
"endpoint": "prescribers",
"params": {
"get_latest_schedule_only": "true",
"limit": "10"
}
}使用最新计划获取项目概述
{
"endpoint": "item-overview",
"params": {
"get_latest_schedule_only": "true",
"limit": "5"
}
}获取具有特定PBS代码的处方者
{
"endpoint": "prescribers",
"params": {
"pbs_code": "10001J",
"get_latest_schedule_only": "true"
}
}认证
该工具使用订阅密钥来访问PBS API。您可以通过在PBS开发者门户上注册来获得自己的密钥。
出于开发目的，请参阅 .env.example 配置详细信息文件。
获取PBS API订阅密钥
要获得您自己的PBS API订阅密钥，请按照以下步骤操作：
- 访问PBS数据API门户网站:
- 首选 https://data-api-portal.health.gov.au/
- 创建账户:
- 点击“注册”以创建新帐户 - 填写您的详细信息并验证您的电子邮件地址
- 订阅PBS API:
- 登录后，导航到“产品”部分 - 选择“PBS Public API v3”产品 - 点击“订阅”请求访问API
- 检索您的订阅密钥:
- 在您的订阅获得批准后，转到您的个人资料 - 导航到“订阅”或“API密钥”部分 - 复制您的主密钥或次密钥
- 配置您的环境:
- 创建一个 .env 文件基于 .env.example 模板 - 替换 your-subscription-key-here 使用您的实际订阅密钥：
PBS_API_SUBSCRIPTION_KEY=your-actual-subscription-key备注：PBS公共API的速率限制为每20秒一个请求。此限制在公共API的所有用户之间共享。对于更高的速率限制或访问禁运数据（未来的时间表），您可能需要通过PBS开发者计划申请特殊访问。
局限性
- PBS公共API的速率限制为每20秒一个请求（在所有用户之间共享）
- 只有当前时间表和过去12个月内发布的时间表可通过公共API获得
- 某些端点需要提供特定参数
- API结构和端点可能会随时间变化
额外资源
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
______________________________________________________________________