使用说明
PokeMCP 的
PokeMCP是一个MCP(模块化命令平台)服务器,通过与 PokeAPI。它提供了一个工具来获取有关任何宝可梦的全面数据,包括基本属性、类型、能力(带效果)、移动(带效果的)和进化链。
特性
- 获取宝可梦基础属性、类型和能力(带效果描述)
- 每个宝可梦最多可检索10个移动,包括移动效果
- 为给定的口袋妖怪提供完整的进化链
- 优雅地处理错误并返回信息丰富的错误消息
需求
- Python 3.11.4+
- httpx (用于异步HTTP请求)
- mcp.server.fastmcp (适用于MCP服务器框架)
安装
- 克隆此存储库:
git clone https://github.com/ChiragAgg5k/poke-mcp.git cd poke-mcp - 使用安装依赖项 紫外线:
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
现在,您可以使用 poke-mcp Claude中的MCP工具:
获取口袋妖怪信息
模拟战斗
了解如何将服务器与Cursor等其他MCP客户端连接 这里.
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"]
}
错误处理
如果找不到口袋妖怪或出现网络错误,响应将包括 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"
}
错误处理
如果找不到口袋妖怪或出现网络错误,响应将包括 error 带有描述性信息的按键。
许可证
该项目使用 PokeAPI 并且旨在用于教育和非商业用途。