kpic-mcp

🚀 KPIC MCP Server

KPIC MCP Server 是一个用于韩国药品信息中心（Korea Pharmaceutical Information Center）API 的模型上下文协议（Model Context Protocol, MCP）服务器。它提供了便捷的方式来查询药品信息，帮助用户快速获取所需的药品数据。

🚀 快速开始

要使用 KPIC MCP Server，你需要按照以下步骤进行操作：

1. 安装依赖：

pnpm install

2. 构建项目：

pnpm build

3. 启动服务器：

pnpm start

4. 开发模式：如果你需要进行开发，可以使用以下命令启动开发模式：

pnpm dev

5. 运行测试：使用以下命令运行测试：

pnpm test

✨ 主要特性

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

1. search_drugs_by_name

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

• 参数：
  • drugname (string)：要搜索的药品名称（英文或韩文）
• 返回值：
  • 搜索到的药品列表（JSON 数组）
  • 每个项目包含药品名称、制造商、功效、用法用量等基本信息

2. get_drug_detail_by_id

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

• 参数：
  • drugcode (string)：药品代码（可从 search_drugs_by_name 的结果中获取）
• 返回值：
  • 药品的详细信息（JSON 数组）
  • 包含的信息：成分、添加剂、储存方法、注意事项、孕妇/哺乳期妇女信息等

📦 安装指南

安装依赖

pnpm install

构建项目

pnpm build

启动服务器

pnpm start

开发模式

pnpm dev

运行测试

pnpm test

💻 使用示例

基础用法

药品搜索

// 搜索泰诺
search_drugs_by_name("타이레놀")

详细信息查询

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

📚 详细文档

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

🔧 技术细节

技术栈

| 属性 | 详情 | |------|------| | 运行时环境 | Node.js 18+ | | 编程语言 | TypeScript 5.x | | 框架 | MCP SDK (@modelcontextprotocol/sdk) | | HTTP 客户端 | 原生 Fetch API | | 测试工具 | Jest + ts-jest | | 代码质量工具 | ESLint, Prettier | | 包管理器 | pnpm |

📄 许可证

本项目采用 MIT 许可证。

⚠️ 重要提示

此服务器使用了 韩国药品信息中心 的公开 API。在使用 API 时，你必须遵守该网站的使用条款。