🚀 PokeMCP
PokeMCP是一个模块化命令平台（MCP）服务器，它通过与 PokeAPI 集成，提供详细的宝可梦信息。它提供了一个工具，用于获取任何宝可梦的全面数据，包括基础属性、类型、特性（含效果）、技能（含效果）和进化链。
🚀 快速开始
PokeMCP可帮助你轻松获取宝可梦的详细信息。只需按照以下步骤操作，就能快速搭建并使用该服务器。
✨ 主要特性
- 获取宝可梦的基础属性、类型和特性（含效果描述）
- 为每只宝可梦检索多达10个技能，包括技能效果
- 提供指定宝可梦的完整进化链
- 优雅地处理错误并返回有信息价值的错误消息
📦 安装指南
环境要求
- Python 3.11.4+
- httpx（用于异步HTTP请求）
- mcp.server.fastmcp（用于MCP服务器框架）
安装步骤
- 克隆此仓库：
git clone https://github.com/ChiragAgg5k/poke-mcp.git cd poke-mcp - 使用 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，仅供教育和非商业用途。