PokeMCP Server - Pokémon Server with Model Context Protocol (MCP)

PokeMCP Server - 使用 Model Context Protocol（MCP）的 Pokémon 服务

描述

PokeMCP Server 是一项使用 Model Context Protocol（MCP）提供 Pokémon 相关功能的服务。该项目支持查询 Pokémon 信息、计算对战结果，以及估算遇见异色 Pokémon 的概率。

功能

• 通过 PokeAPI 获取 Pokémon 信息
• 计算两只 Pokémon 之间的对战结果
• 估算遇见异色 Pokémon 的概率
• 基于 Clean Architecture 原则构建
• 实现 MCP 协议以支持客户端与服务端通信

要求

• .NET 9
• 互联网连接（用于访问 PokeAPI）

安装

1. 克隆代码库： git clone https://github.com/GuillermoRuizDev/PokeMCP-Server.git cd PokeMCP

2. Restore dependencies: dotnet restore

3. Build the project: dotnet build

Running the Application

Development Mode

To run the application in development mode:

dotnet run --project PokeMCP

By default, the application will run at:

• HTTP: http://localhost:3002
• HTTPS: https://localhost:7133

You can verify it's working by accessing http://localhost:3002/home in your browser, where you should see the message: "Pokemon MCP Server - Ready for use with SSE".

Integration with MCP Clients

To use this server from an MCP client (such as Semantic Kernel or compatible applications):

1. Connect to the MCP server using an MCP client by adding the following json to the mcp.json file:

{
    "servers": {        
        "pokeapi-mcp-server": {
            "type": "sse",
            "url": "http://localhost:3002/sse"
        }
    }
}

2. 使用提供的工具与 Pokémon 功能交互

项目结构（Clean Architecture）

PokeMCP/
├── Core/                      # Domain Layer
│   ├── Entities/              # Domain entities
│   ├── Enums/                 # Enumerations
│   └── Interfaces/            # Repository and service interfaces
├── Application/               # Application Layer
│   ├── DTOs/                  # Data transfer objects
│   └── UseCases/              # Use cases and business logic implementation
├── Infrastructure/            # Infrastructure Layer
│   ├── Clients/               # External service clients (PokeAPI)
│   └── Repositories/          # Repository implementations
└── Tools/                     # MCP tools for exposing functionality

MCP 服务用法

该服务通过 MCP 协议提供以下功能：

PokeApiTool

• GetPokemonInfo(pokemonName)：根据 Pokémon 名称或 ID 获取详细信息。

PokeFunctionsTool

• GetBattleResult(attacker, defender)：计算两只 Pokémon 之间的对战结果。
• ProbabilityFindingShiny(encounters, hasShinyCharm)：计算遇见异色 Pokémon 的概率。

许可证

本项目采用 MIT License 许可。

联系方式

如果你有问题或建议，欢迎提出 issue，或通过 LinkedIn 联系我。

致谢

• 感谢 PokeAPI 提供 Pokémon 数据
• 感谢 Model Context Protocol 提供通信协议