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

🔧 技術細節

技術棧

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

此服務器使用了 韓國藥品信息中心 的公開 API。在使用 API 時，你必須遵守該網站的使用條款。