Pokemon MCP Demo

The Pokemon MCP Demo provides a local MCP server that serves Pokemon data and attack actions, enabling you to interact with Pokemon capabilities through an MCP client and an HTTP gateway for LLM-based tooling. It showcases how you can run a server locally, connect a client to access data and actions, and expose tools to a larger system via an HTTP endpoint.

How to use

You will run a local MCP server by launching the client, which starts the server in the background for you. Then you can query available tools and trigger actions like executing a Pokemon attack using an LLM.

How to install

Prerequisites: you need Bun installed to run the demo. You will install dependencies, then start the client and the HTTP gateway.

bun install

Additional sections

Run the MCP client to start the server and then run the HTTP server to expose tools for LLM integration. You will need an API key for the HTTP gateway to access the OpenRouter service.

# Start the MCP client (which launches the MCP server)
bun mcp_client.ts

# Start the HTTP server with your OpenRouter API key
export OPENROUTER_API_KEY=your_api_key_here
bun http_server.ts

Available tools

tools

Endpoint to list available tools exposed by the HTTP server. Use this to discover what actions you can invoke from an LLM or external client.

attack

Endpoint to execute a random Pokemon attack using the integrated LLM. This tool triggers a Pokemon attack action on demand.