药品信息查询服务

KPIC MCP Server是一个基于Model Context Protocol (MCP)的服务器,提供韩国药学信息中心(KPIC)的药品信息查询功能,包括按药品名称搜索和按药品代码获取详细信息。

  • by antegral
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 antegral/kpic-mcp

使用说明

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时,必须遵守该网站的使用条款。