PokeMCP-Server

PokeMCP-Server

0
entertainment_and_mediaknowledge_and_memory

PokeMCP Server offers a platform for interacting with Pokémon data using the Model Context Protocol. It allows for querying Pokémon details, calculating battle outcomes, and estimating shiny Pokémon probabilities. Built on Clean Architecture principles, it serves as a versatile tool for Pokémon enthusiasts.

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

Description

PokeMCP Server is a server that provides Pokémon-related functionalities using the Model Context Protocol (MCP). The project allows querying information about Pokémon, calculating battle outcomes, and estimating shiny Pokémon encounter probabilities.

Features

  • Retrieve Pokémon information through the PokeAPI
  • Calculate battle results between two Pokémon
  • Estimate probabilities for finding shiny Pokémon
  • Built on Clean Architecture principles
  • Implements the MCP protocol for client-server communication

Requirements

  • .NET 9
  • Internet connection (to access the PokeAPI)

Installation

  1. Clone the repository: 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:

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"
        }
    }
}
  1. Use the exposed tools to interact with the Pokémon functionalities

Project Structure (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 Server Usage

The server exposes the following functionalities through the MCP protocol:

PokeApiTool

  • GetPokemonInfo(pokemonName): Retrieves detailed information about a Pokémon by its name or ID.

PokeFunctionsTool

  • GetBattleResult(attacker, defender): Calculates the result of a battle between two Pokémon.
  • ProbabilityFindingShiny(encounters, hasShinyCharm): Calculates the probability of finding a shiny Pokémon.

License

This project is licensed under the MIT License.

Contact

If you have questions or suggestions, feel free to open an issue or contact me at LinkedIn.

Acknowledgments