KPIC MCP Server

KPIC MCP服务器

 

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

功能

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

1. search_drugs_by_name

用药品名称搜索大致信息。

参数：

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

返回值：

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

2. get_drug_detail_by_id

使用药品代码查询详细信息。

参数：

• drugcode (string): 药品代码 (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时，必须遵守该网站的使用条款。