PokeMCP

PokeMCP 是一个 MCP（模块化指挥平台）服务器，通过与PokeAPI集成，提供宝可梦的详细信息。它提供了一个工具来获取任何宝可梦的综合数据，包括基础属性、类型、能力（含效果）、招式（含效果）和进化链。

特征

• 获取神奇宝贝的基本统计数据、类型和能力（附带效果描述）

• 检索每个宝可梦最多 10 个招式，包括招式效果

• 提供特定神奇宝贝的完整进化链

• 妥善处理错误并返回信息丰富的错误消息

Related MCP server: Poke-MCP

要求

• 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：

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 (str): 神奇宝贝的名字（不区分大小写）

返回

具有以下结构的字典：

{
  "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"]
}

错误处理

如果未找到 Pokémon 或者出现网络错误，响应将包含带有描述性消息的error键。

工具： simulate_battle

使用核心机制（统计数据、类型和状态效果）模拟两个神奇宝贝之间的神奇宝贝战斗。

参数

• pokemon1 (str): 第一个神奇宝贝的名字（不区分大小写）

• pokemon2 (str): 第二只神奇宝贝的名字（不区分大小写）

返回

具有以下结构的字典：

{
  "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"
}

错误处理

如果未找到 Pokémon 或者出现网络错误，响应将包含带有描述性消息的error键。

执照

该项目使用PokeAPI ，旨在用于教育和非商业用途。