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，仅供教育和非商业用途。