宝可梦MCP服务器
该项目实现了 模型上下文协议（MCP）服务器 它为AI模型提供了对口袋妖怪知识和战斗模拟的访问。\ 它暴露了两个主要组件：
- 宝可梦数据资源 –公开全面的宝可梦数据（统计数据、类型、动作、能力、进化）。
- 作战模拟工具 –使用核心机制模拟任意两个宝可梦之间的战斗。
______________________________________________________________________
📜 系统流程图
______________________________________________________________________
🚀 安装说明
先决条件
- Python 3.9+
pip install -r requirements.txt
运行服务器
python3 main.pyMCP集成
您可以将MCP服务器安装到Copilot中/ mcpc 使用：
- 创建一个文件夹.vcode/mcp.json
- 在里面粘贴你的网址
{
"servers": {
"pokemonG0": {
"url": "http://localhost:6274/mcp",
"type": "http"
},
},
"inputs": []
}或通过SSE：
- 安装任何mcp-cli
- 此项目中使用的代码
git clone https://github.com/JorianWoltjer/mcp-cli.git && cd mcp-cli
python3 -m pip install requests
sudo ln -s $(pwd)/mcpc.py /usr/local/bin/mcpc
mcpc localhost:6274______________________________________________________________________
📊 第1部分：口袋妖怪数据资源
服务器连接到 PokéAPI 并公开资源：
- 神奇宝贝信息 (
/api/pokemon/{name})\
返回基本属性、能力、类型、移动。
- 移动信息 (
/api/move/{name})\
返回移动功率、类型、精度、效果。
- 能力信息 (
/api/ability/{name})\
返回宝可梦能力的描述。
- 进化链 (
/api/evolution/{pokemon})\
返回完整的进化链。
✅ 查询示例
使用 LLM:
give me pokemon pikachu
tell me about the move thunderbolt
give me evolution chain of bulbasaur使用mcp-cli：
mcpc http://0.0.0.0:6274 pokemon_resource_api_pokemon__id_or_name__get '{"id_or_name": "pikachu"}'______________________________________________________________________
⚔️ 第2部分：作战模拟工具
模拟两个宝可梦之间的战斗：
- 类型有效性 乘数（火>草，水>火等）。
- 损伤计算 使用统计数据+移动力量。
- 翻转订单 基于速度统计。
- 状态影响：瘫痪、烧伤、中毒。
- 战斗日志 每一个转弯。
- 胜者确定 当口袋妖怪晕倒时。
✅ 示例用法
使用 LLM:
simulate a battle between pikachu and bulbasaur使用mcp-cli：
mcpc http://0.0.0.0:6274 battle_api_battle_post '{"pokemon1": "pikachu", "pokemon2": "bulbasaur"}'样本输出：
--- Turn 1 ---
Pikachu used Thunderbolt! It dealt 22 damage.
Charmander is paralyzed and may not move!
Charmander used Ember! It dealt 12 damage.
--- Turn 2 ---
Pikachu used Quick Attack! It dealt 14 damage.
Charmander fainted!
Winner: Pikachu______________________________________________________________________
📹 项目说明
[！\[观看演示\] ](https://youtu.be/4pxFk3v_Pb4)
📂 项目结构
- main.py # Main FastAPI + MCP server
- resources
--- pokemon_resources.py
- tools
--- battle_tool.py
- domian
--- battle_engine.py # Battle mechanics and simulation
--- pokeapi.py # Pokémon, Move, Ability, Evolution resources
- README.md # Documentation
- requirements.txt______________________________________________________________________