项目简介
Pokemon MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它利用 PokebuilAPI 提供的宝可梦数据,为 LLM 客户端提供宝可梦相关的上下文信息和工具。通过此服务器,LLM 应用可以方便地查询宝可梦信息、构建宝可梦队伍,为游戏助手、宝可梦知识问答等应用场景提供支持。
主要功能
- 查询宝可梦信息:通过宝可梦 ID 或名称快速获取宝可梦的详细信息,包括类型、属性、技能、图片等。
- 按世代列出宝可梦:根据宝可梦的世代(例如第一世代、第二世代等)列出该世代的所有宝可梦。
- 按双属性搜索宝可梦:查找同时拥有指定两种属性的宝可梦,例如“水”和“飞行”属性的宝可梦。
- 生成随机宝可梦队伍:一键生成包含 6 只随机宝可梦的队伍,用于快速开始游戏或测试。
- 获取平衡队伍建议:根据属性相克等因素,生成一个属性相对平衡的宝可梦队伍建议,帮助玩家更好地进行对战。
- 查找特定属性弱点的宝可梦:查找对指定属性(例如“火”)存在弱点的宝可梦,用于制定战斗策略。
- 列出所有宝可梦属性:获取游戏中所有可用的宝可梦属性列表,方便用户了解属性种类。
安装步骤
- 克隆仓库:
git clone https://github.com/bigwhoop0/Pokemon-MCPServer.git cd Pokemon-MCPServer - 构建项目:
确保您的电脑上已安装 .NET 9.0 SDK (或更高版本),然后在仓库根目录下运行以下命令来构建项目:
dotnet build
服务器配置
要将 Pokemon MCP Server 集成到 MCP 客户端,您需要在 MCP 客户端的服务器配置中添加以下 JSON 配置信息。这告诉 MCP 客户端如何启动和连接到 Pokemon MCP Server。
{ "serverName": "pokemon-mcp-server", // 自定义服务器名称,用于在 MCP 客户端中标识 "command": "dotnet", // 运行服务器的命令,通常为 dotnet "args": ["run", "--project", "PokemonMCP/PokemonMCP.csproj"] // 启动参数,指定项目文件路径 }
配置说明:
- 'serverName':服务器的名称,您可以根据需要自定义设置,例如 "pokemon-server" 或 "my-pokemon-tools"。这个名称将显示在 MCP 客户端的服务器列表中。
- 'command':启动服务器程序的可执行命令。对于 .NET 项目,通常使用 'dotnet' 命令来运行。
- 'args':传递给 'command' 的命令行参数。这里 '"run --project PokemonMCP/PokemonMCP.csproj"' 指示 'dotnet' 运行 'PokemonMCP' 文件夹下的 'PokemonMCP.csproj' 项目文件,从而启动 Pokemon MCP Server。
基本使用方法
服务器成功启动后,MCP 客户端可以通过发送预定义的工具调用请求与服务器交互。以下是一些基本的使用示例,您可以通过 MCP 客户端调用这些工具来获取宝可梦相关的数据:
-
获取 ID 为 25 的宝可梦信息
GetPokemonById 25 -
获取名为 "pikachu" 的宝可梦信息
GetPokemonByName pikachu -
列出第一世代的宝可梦
GetPokemonByGeneration 1 -
查找属性为 "Eau" 和 "Vol" 的宝可梦
GetPokemonByDualTypes Eau Vol -
生成一个随机宝可梦队伍
GetRandomTeam -
获取一个平衡的宝可梦队伍建议
GetBalancedTeamSuggestion -
查找对 "Feu" 属性有弱点的宝可梦
GetPokemonWithWeakness Feu -
列出所有可用的宝可梦属性
GetAllTypes
请注意,工具的具体名称和参数需要与服务器的定义保持一致。您可以在仓库的 'README.md' 文件或源代码中找到更详细的工具描述和使用方法。
信息
分类
数据库与文件