Pokémon信息查询工具

PokeMCP是一个基于MCP(模块化命令平台)的服务,通过与PokeAPI集成,提供详细的宝可梦信息查询和战斗模拟功能。

  • by ChiragAgg5k
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 chiragagg5k/poke-mcp

使用说明

PokeMCP 的

PokeMCP是一个MCP(模块化命令平台)服务器,通过与 PokeAPI。它提供了一个工具来获取有关任何宝可梦的全面数据,包括基本属性、类型、能力(带效果)、移动(带效果的)和进化链。

特性

  • 获取宝可梦基础属性、类型和能力(带效果描述)
  • 每个宝可梦最多可检索10个移动,包括移动效果
  • 为给定的口袋妖怪提供完整的进化链
  • 优雅地处理错误并返回信息丰富的错误消息

需求

安装

  1. 克隆此存储库:
    git clone https://github.com/ChiragAgg5k/poke-mcp.git
    cd poke-mcp
    
  2. 使用安装依赖项 紫外线:
    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 并且旨在用于教育和非商业用途。