项目简介

Pokemon MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它利用 PokebuilAPI 提供的宝可梦数据,为 LLM 客户端提供宝可梦相关的上下文信息和工具。通过此服务器,LLM 应用可以方便地查询宝可梦信息、构建宝可梦队伍,为游戏助手、宝可梦知识问答等应用场景提供支持。

主要功能

  • 查询宝可梦信息:通过宝可梦 ID 或名称快速获取宝可梦的详细信息,包括类型、属性、技能、图片等。
  • 按世代列出宝可梦:根据宝可梦的世代(例如第一世代、第二世代等)列出该世代的所有宝可梦。
  • 按双属性搜索宝可梦:查找同时拥有指定两种属性的宝可梦,例如“水”和“飞行”属性的宝可梦。
  • 生成随机宝可梦队伍:一键生成包含 6 只随机宝可梦的队伍,用于快速开始游戏或测试。
  • 获取平衡队伍建议:根据属性相克等因素,生成一个属性相对平衡的宝可梦队伍建议,帮助玩家更好地进行对战。
  • 查找特定属性弱点的宝可梦:查找对指定属性(例如“火”)存在弱点的宝可梦,用于制定战斗策略。
  • 列出所有宝可梦属性:获取游戏中所有可用的宝可梦属性列表,方便用户了解属性种类。

安装步骤

  1. 克隆仓库
    git clone https://github.com/bigwhoop0/Pokemon-MCPServer.git
    cd Pokemon-MCPServer
  2. 构建项目: 确保您的电脑上已安装 .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' 文件或源代码中找到更详细的工具描述和使用方法。

信息

分类

数据库与文件