Poke MCP

🚀 PokeMCP

PokeMCP是一個模塊化命令平臺（MCP）服務器，它通過與 PokeAPI 集成，提供詳細的寶可夢信息。它提供了一個工具，用於獲取任何寶可夢的全面數據，包括基礎屬性、類型、特性（含效果）、技能（含效果）和進化鏈。

🚀 快速開始

PokeMCP可幫助你輕鬆獲取寶可夢的詳細信息。只需按照以下步驟操作，就能快速搭建並使用該服務器。

✨ 主要特性

• 獲取寶可夢的基礎屬性、類型和特性（含效果描述）
• 為每隻寶可夢檢索多達10個技能，包括技能效果
• 提供指定寶可夢的完整進化鏈
• 優雅地處理錯誤並返回有信息價值的錯誤消息

📦 安裝指南

環境要求

• Python 3.11.4+
• httpx（用於異步HTTP請求）
• mcp.server.fastmcp（用於MCP服務器框架）

安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/ChiragAgg5k/poke-mcp.git
   cd poke-mcp
   

2. 使用 uv 安裝依賴項：

   uv sync
   

💻 使用示例

開發服務器

使用uv運行服務器（確保你擁有所需的MCP基礎設施）：

uv run mcp dev server.py

與Claude連接

運行以下命令與Claude連接：

uv run mcp install server.py

結果應如下所示：

Added server 'poke-mcp' to Claude config   
Successfully installed poke-mcp in Claude app 

現在你可以在Claude中使用 poke-mcp MCP工具：

獲取寶可夢信息

模擬戰鬥

瞭解如何將服務器與其他MCP客戶端（如Cursor）連接，請點擊 此處。

📚 詳細文檔

📄 API文檔

工具：get_pokemon_info

獲取寶可夢的詳細信息。

參數

• pokemon_name（字符串）：寶可夢的名稱（不區分大小寫）

返回值

一個具有以下結構的字典：

{
  "name": "pikachu",
  "id": 25,
  "base_stats": {
    "hp": 35,
    "attack": 55,
    ...
  },
  "types": ["electric"],
  "abilities": [
    {"name": "static", "effect": "May paralyze on contact."},
    ...
  ],
  "moves": [
    {"name": "thunder-shock", "effect": "Has a 10% chance to paralyze the target."},
    ...
  ],
  "evolution_chain": ["pichu", "pikachu", "raichu"]
}

錯誤處理

如果未找到寶可夢或發生網絡錯誤，響應將包含一個帶有描述性消息的 error 鍵。

工具：simulate_battle

使用核心機制（屬性、類型和狀態效果）模擬兩隻寶可夢之間的戰鬥。

參數

• pokemon1（字符串）：第一隻寶可夢的名稱（不區分大小寫）
• pokemon2（字符串）：第二隻寶可夢的名稱（不區分大小寫）

返回值

一個具有以下結構的字典：

{
  "pokemon1": "pikachu",
  "pokemon2": "charizard",
  "initial_hp": {
    "pikachu": 35,
    "charizard": 78
  },
  "battle_log": [
    "Turn 1:",
    "charizard uses mega-punch and deals 75 damage! (pikachu HP: 0)",
    "pikachu fainted!",
    "Winner: charizard!"
  ],
  "winner": "charizard"
}

錯誤處理

如果未找到任何一隻寶可夢或發生網絡錯誤，響應將包含一個帶有描述性消息的 error 鍵。

📄 許可證

本項目使用 PokeAPI，僅供教育和非商業用途。