pokemon g0

宝可梦MCP服务器

该项目实现了 模型上下文协议（MCP）服务器 它为AI模型提供了对口袋妖怪知识和战斗模拟的访问。\ 它暴露了两个主要组件：

1. 宝可梦数据资源 –公开全面的宝可梦数据（统计数据、类型、动作、能力、进化）。
2. 作战模拟工具 –使用核心机制模拟任意两个宝可梦之间的战斗。

______________________________________________________________________

📜 系统流程图

______________________________________________________________________

🚀 安装说明

先决条件

• Python 3.9+
• pip install -r requirements.txt

运行服务器

python3 main.py

MCP集成

您可以将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

______________________________________________________________________