Poke MCP

🚀 寶可夢MCP服務器

這是一個模型上下文協議（MCP）服務器，可通過PokeAPI訪問寶可夢數據。該服務器允許Claude和其他支持MCP的客戶端獲取寶可夢的詳細信息，包括屬性、類型、技能和進化鏈等。

🚀 快速開始

寶可夢MCP服務器可幫助你便捷地獲取寶可夢的各類詳細信息。以下是使用該服務器的步驟：

前提條件

• Node.js 18 或更高版本
• npm 或 yarn 包管理器

安裝步驟

1. 克隆此倉庫：

git clone <your-repository-url>
cd pokemon-mcp

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

運行模式

開發模式

若要在開發模式下運行服務器，可使用以下命令：

npm run dev

生產模式

構建完成後，你可以運行編譯後的服務器：

node build/index.js

✨ 主要特性

• 寶可夢總覽：獲取任何寶可夢的全面信息，包括名稱、類型、基礎屬性和描述。
• 技能詳情：獲取寶可夢技能的詳細信息，包括威力、PP值、類型和傷害類別。
• 進化鏈：檢索任何寶可夢的完整進化鏈。

💻 使用示例

可用工具

1. 獲取寶可夢總覽

• 工具名稱：get_pokemon_overviews
• 描述：獲取多個寶可夢的總覽信息
• 參數：
  • pokemonNames：寶可夢名稱數組（例如，['pikachu', 'charizard']）
• 返回值：每個寶可夢的名稱、類型、基礎屬性和描述

2. 獲取技能詳情

• 工具名稱：get_move_detail
• 描述：獲取特定寶可夢技能的詳細信息
• 參數：
  • move：技能名稱（例如，'hyper beam', 'thunder bolt'）
• 返回值：技能名稱、威力、PP值、類型、類別和傷害類別

3. 獲取進化鏈

• 工具名稱：get_evolution_chain
• 描述：獲取寶可夢的完整進化鏈
• 參數：
  • pokemonName：寶可夢名稱（例如，'bulbasaur'）
• 返回值：從基礎形態到最終進化形態的完整進化鏈

與Claude桌面版連接

若要將此MCP服務器與Claude桌面版一起使用，你需要在Claude桌面版設置中進行配置。

配置步驟

1. 打開Claude桌面版。
2. 導航至“設置”→“開發者”→“編輯配置”。
3. 將以下配置添加到你的claude_desktop_config.json文件中：

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/your/pokemon-mcp/build/index.js"],
      "env": {}
    }
  }
}

重要提示：請將/path/to/your/pokemon-mcp/替換為你項目目錄的實際絕對路徑。

替代方法：使用npx（如果已發佈）

如果你已將此項目發佈為npm包，可以使用以下配置：

{
  "mcpServers": {
    "pokemon": {
      "command": "npx",
      "args": ["pokemon-mcp"],
      "env": {}
    }
  }
}

驗證連接

1. 更新配置後重啟Claude桌面版。
2. 在Claude界面中查找🔌圖標，該圖標表示MCP服務器已連接。
3. 你應該會看到“pokemon”作為可用的MCP服務器列出。
4. 通過向Claude詢問寶可夢信息來測試連接。

與Claude的使用示例

連接成功後，你可以向Claude提出以下問題：

• “你能獲取皮卡丘和噴火龍的信息嗎？”
• “技能十萬伏特的詳情是什麼？”
• “給我展示傑尼龜的進化鏈”
• “比較妙蛙種子、小火龍和傑尼龜的屬性”

📚 詳細文檔

API數據源

此服務器從PokeAPI獲取數據，這是一個免費且開放的寶可夢API。服務器包含緩存機制，以提高性能並減少API調用次數。具體而言，本項目使用了pokedex-promise-v2。

項目結構

pokemon-mcp/
├── src/
│   ├── index.ts          # 主要的MCP服務器實現
│   └── pokemonHelper.ts  # 寶可夢API輔助函數
├── build/                # 編譯後的JavaScript輸出
├── package.json
├── tsconfig.json
└── README.md

開發腳本

• npm run dev - 在開發模式下運行服務器，並支持熱重載
• npm run build - 將TypeScript編譯為JavaScript

依賴項

• @modelcontextprotocol/sdk - 用於構建MCP服務器的MCP SDK
• pokedex-promise-v2 - 基於Promise的PokeAPI包裝器
• zod - 模式驗證庫

故障排除

服務器無法連接

• 確保Claude桌面版配置中的路徑正確且為絕對路徑。
• 驗證構建目錄是否存在幷包含編譯後的JavaScript文件。
• 檢查Node.js是否已安裝並可從命令行訪問。

未找到寶可夢

• 確保寶可夢名稱拼寫正確（不區分大小寫）。
• 使用官方寶可夢名稱（例如，使用“nidoran-f”表示雌性尼多蘭）。

未找到技能

• 技能名稱應使用連字符代替空格（例如，使用“hyper-beam”而不是“hyper beam”）。
• 服務器會自動將空格轉換為連字符，但建議使用正確的格式。

📄 許可證

本項目採用ISC許可證。

貢獻

歡迎提交問題和改進請求！