MCP Pokeapi Server

🚀 mcp-pokeapi-server

本項目將POKEAPI與MCP（模型上下文協議）規範相結合，為用戶提供了一個獲取寶可夢信息的工具服務器。它允許LLM應用或MCP客戶端通過特定協議方便地獲取寶可夢的相關信息。

🚀 快速開始

安裝依賴

npm install

項目構建

npx tsc

開發環境啟動（使用ts-node）

npx ts-node src/index.ts

運行測試

npm test

✨ 主要特性

• 採用MCP協議（JSON - RPC 2.0 over stdio），支持LLM應用和MCP客戶端獲取寶可夢信息。
• 藉助POKEAPI（https://pokeapi.co/）獲取寶可夢的詳細數據。
• 使用zod進行模式驗證，確保數據的準確性。

💻 使用示例

基礎用法

從MCP客戶端獲取工具列表（list_tools）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "list_tools"
}

響應示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "getPokemonInfo",
        "description": "從寶可夢名稱或ID中，通過POKEAPI獲取寶可夢信息。",
        "input_schema": { ... },
        "output_schema": { ... }
      }
    ]
  }
}

獲取寶可夢信息（call_tool）

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "call_tool",
  "params": {
    "name": "getPokemonInfo",
    "arguments": {
      "nameOrId": "pikachu"
    }
  }
}

響應示例

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "json",
        "data": {
          "name": "pikachu",
          "id": 25,
          "height": 4,
          "weight": 60,
          "types": ["electric"]
        }
      }
    ]
  }
}

📚 詳細文檔

參考資料

• MCP官方文檔
• POKEAPI官方網站
• Zenn: MCP入門