KPIC MCP Server

这是为韩国药学信息中心（Korea Pharmaceutical Information Center）API设计的模型上下文协议（MCP）服务器。

功能

此MCP服务器提供了两种工具来查询韩国药学信息中心的药品信息：

1. search_drugs_by_name

通过药品名称搜索大致信息。

参数：

• drugname (字符串)：要搜索的药品名称（英文或韩文）

返回值：

• 搜索到的药品列表（JSON数组）
• 每个条目包含药品名、制造商、功效、用法用量等基本信息

2. get_drug_detail_by_id

通过药品代码查询详细信息。

参数：

• drugcode (字符串)：药品代码（从search_drugs_by_name的结果中获得）

返回值：

• 药品的详细信息（JSON数组）
• 包含的信息有成分、添加剂、储存方法、注意事项、孕妇/哺乳期妇女信息等

安装

pnpm install

构建

pnpm build

运行

pnpm start

开发模式

pnpm dev

测试

pnpm test

MCP客户端设置

要在Claude Desktop或其他MCP客户端中使用此服务器，请在设置文件中添加以下内容：

{
  "mcpServers": {
    "kpic": {
      "command": "node",
      "args": ["/path/to/kpic-mcp/dist/index.js"]
    }
  }
}

项目结构

kpic-mcp/
├── src/
│   ├── index.ts          # MCP服务器主入口点
│   ├── kpic-api.ts       # KPIC API客户端函数
│   └── types.ts          # TypeScript类型定义
├── __tests__/
│   └── kpic-api.test.ts  # 测试代码
├── dist/                 # 构建结果（TypeScript编译后）
├── package.json
├── tsconfig.json
└── README.md

使用示例

药品搜索

// 搜索泰诺
search_drugs_by_name("泰诺")

查询详细信息

// 通过特定药品代码查询详细信息
get_drug_detail_by_id("2013062800004")

技术栈

• 运行时：Node.js 18+
• 语言：TypeScript 5.x
• 框架：MCP SDK (@modelcontextprotocol/sdk)
• HTTP客户端：原生Fetch API
• 测试：Jest + ts-jest
• 代码质量：ESLint, Prettier
• 包管理器：pnpm

许可证

MIT

注意事项

此服务器使用韩国药学信息中心的公开API。使用API时需遵守该网站的服务条款。