项目简介

PokeMCP是一个基于Model Context Protocol (MCP) 的服务器实现，通过集成PokeAPI，为LLM客户端提供丰富的宝可梦数据查询和简单的对战模拟功能。它注册了可通过MCP协议调用的特定工具（Tools）。

主要功能点

• 查询宝可梦详细信息：通过工具查询指定宝可梦的综合数据，包括基础属性、类型、特性（带效果描述）、招式（前10个，带效果描述）和进化链。
• 模拟宝可梦对战：基于简化规则，模拟两只宝可梦之间的回合制对战，并提供详细的对战过程日志及最终胜者。
• 错误处理：对查询不到宝可梦或网络请求失败等情况，提供友好的错误提示信息。

安装步骤

1. 环境准备：需要Python 3.11.4+环境。
2. 克隆仓库：打开终端，执行以下命令克隆项目仓库并进入目录：

   git clone https://github.com/ChiragAgg5k/poke-mcp.git
   cd poke-mcp
   

3. 安装依赖：推荐使用'uv'工具安装项目依赖。如果在您的系统中没有安装'uv'，可以先通过pip安装：'pip install uv'。然后执行：

   uv sync
   

   （您也可以选择其他Python包管理工具如poetry或pipenv来安装依赖）

服务器配置

PokeMCP服务器是为MCP客户端（通常是LLM应用）提供服务的。MCP客户端需要配置此服务器的启动信息，以便连接并发现其能力（如工具）。配置通常包括服务器名称、启动命令及其参数。

根据该仓库的说明，您可以配置您的MCP客户端使用以下信息连接到PokeMCP服务器：

• 服务器名称 (Server Name): 'poke-mcp'
• 启动命令 (Command): 'uv'
• 命令参数 (Args): 'run', 'mcp', 'dev', 'server.py'

请确保您的系统已安装'uv'工具，且在项目克隆的目录下执行此命令（或配置客户端在正确的目录下启动）。

基本使用方法

1. 启动服务器：根据上述配置信息，通过MCP客户端启动PokeMCP服务器。例如，在项目目录下，您可以使用命令 'uv run mcp dev server.py' 手动启动服务器（实际使用中通常由MCP客户端负责启动和管理）。
2. 客户端调用工具：MCP客户端连接到PokeMCP服务器后，可以通过MCP协议调用服务器注册的工具。当前暴露的工具有两个：
   • 'get_pokemon_info': 用于查询宝可梦信息。客户端调用时需提供一个字符串参数，即宝可梦的名称（例如 '"pikachu"'）。服务器将返回包含该宝可梦详细信息的字典。
   • 'simulate_battle': 用于模拟宝可梦对战。客户端调用时需提供两个字符串参数，分别代表参与对战的两只宝可梦名称（例如 '"pikachu"', '"bulbasaur"'）。服务器将返回包含对战日志和胜者的字典。

LLM客户端通常会根据用户的自然语言请求，解析出意图和参数，然后调用相应的MCP工具。