PokeMCP

PokeMCP 是一个 MCP（模块化命令平台）服务器，通过集成 PokeAPI 提供详细的宝可梦信息。它提供了一个工具来获取关于任何宝可梦的全面数据，包括基础状态、类型、能力（附带效果）、招式（附带效果）以及进化链。

功能

• 获取宝可梦的基础状态、类型和能力（附带效果描述）
• 每个宝可梦最多获取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

结果应如下所示：

已将服务器 'poke-mcp' 添加到 Claude 配置中
成功在 Claude 应用中安装 poke-mcp

现在您可以在 Claude 中使用 poke-mcp MCP 工具：

获取宝可梦信息

<img src="assets/claude_get_pokemon_info.png" alt="Claude with PokeMCP" width="500">

模拟战斗

<img src="assets/claude_simulate_battle.png" alt="Claude with PokeMCP" width="500">

了解如何将服务器与其他 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": "接触时可能麻痹对手"},
    ...
  ],
  "moves": [
    {"name": "thunder-shock", "effect": "有10%几率使目标麻痹"},
    ...
  ],
  "evolution_chain": ["pichu", "pikachu", "raichu"]
}

错误处理

如果未找到宝可梦或发生网络错误，响应将包含带有描述性消息的 error 键。

工具：simulate_battle

使用核心机制（状态、类型和状态效果）模拟两个宝可梦之间的战斗。

参数

• pokemon1 (str): 第一个宝可梦的名字（不区分大小写）
• pokemon2 (str): 第二个宝可梦的名字（不区分大小写）

返回值

具有以下结构的字典：

{
  "pokemon1": "pikachu",
  "pokemon2": "charizard",
  "initial_hp": {
    "pikachu": 35,
    "charizard": 78
  },
  "battle_log": [
    "第1回合：",
    "charizard 使用 mega-punch 并造成75伤害！(pikachu 血量：0)",
    "pikachu 倒下了！",
    "胜者：charizard！"
  ],
  "winner": "charizard"
}

错误处理

如果未找到任一宝可梦或发生网络错误，响应将包含带有描述性消息的 error 键。

许可证

本项目使用 PokeAPI 并且仅限于教育和非商业用途。 </中文翻译>