Kpic MCP

🚀 KPIC MCP Server

このサーバーは、韓国医薬品情報センタ（Korea Pharmaceutical Information Center）のAPI用のModel Context Protocol (MCP) サーバーです。医薬品情報の検索や詳細情報の取得を可能にします。

🚀 クイックスタート

KPIC MCP Serverを使い始めるには、以下の手順に従ってください。

インストール

pnpm install

ビルド

pnpm build

実行

pnpm start

開発モード

pnpm dev

テスト

pnpm test

✨ 主な機能

このMCPサーバーは、韓国医薬品情報センタの医薬品情報を検索するための2つのツールを提供します。

1. search_drugs_by_name

医薬品名を使って概略的な情報を検索します。

パラメータ:

• drugname (string): 検索する医薬品の名前（英語または韓国語）

戻り値:

• 検索された医薬品のリスト（JSON配列）
• 各項目には、医薬品名、製造会社、効能、用法用量などの基本情報が含まれます。

2. get_drug_detail_by_id

医薬品コードを使って詳細情報を取得します。

パラメータ:

• drugcode (string): 医薬品コード（search_drugs_by_nameの結果から取得）

戻り値:

• 医薬品の詳細情報（JSON配列）
• 含まれる情報: 成分、添加物、保管方法、注意事項、妊婦/授乳婦に関する情報など

📦 インストール

pnpm install

💻 使用例

基本的な使用法

医薬品検索

// タイレノールを検索
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クライアント: Native Fetch API
• テスト: Jest + ts-jest
• コード品質: ESLint, Prettier
• パッケージマネージャー: pnpm

📄 ライセンス

MIT

⚠️ 重要提示

このサーバーは韓国医薬品情報センタの公開APIを使用しています。APIを使用する際には、当該サイトの利用規約を遵守する必要があります。