Pokemon MCP Demo

Name: Pokemon MCP Demo
Author: danwritecode

@danwritecode

Repository

About Pokemon MCP Demo

A quick pokemon demo to showcase MCP server, client, and host

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-client-server-host-demo": {
      "command": "bun",
      "args": [
        "mcp_client.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Pokemon MCP Demo?

Pokemon MCP Demo is a demonstration project that implements the Model Context Protocol (MCP) to provide Pokemon data and attack capabilities. It includes an MCP server and client, plus an HTTP server that allows LLMs to interact with Pokemon tools via OpenRouter. The project is built with Bun and is intended for developers exploring MCP integrations.

How to use Pokemon MCP Demo?

Install dependencies with bun install. To run the MCP server and client demo, execute bun mcp_client.ts. To use the HTTP server with LLM integration, set the OPENROUTER_API_KEY environment variable and run bun http_server.ts, then access http://localhost:3005 for the /tools and /attack endpoints.

Key features of Pokemon MCP Demo

MCP server providing Pokemon data and attack capabilities
MCP client that interacts with the server
HTTP server that exposes tools via OpenRouter API
Endpoints for listing tools (/tools) and executing random attacks (/attack)
Built using Bun as the JavaScript runtime

Use cases of Pokemon MCP Demo

Learning how to build and test MCP servers and clients
Demonstrating tool integration between a language model and Pokemon data
Experimenting with LLM-driven random Pokemon attacks via an HTTP API

FAQ from Pokemon MCP Demo

What dependencies does Pokemon MCP Demo require?

The project requires Bun as its JavaScript runtime. No other dependencies are explicitly listed beyond the bun install command.

How do I run the MCP server and client demo?

Run the client with bun mcp_client.ts, which automatically launches the MCP server.

How do I use the HTTP server with an LLM?

Set the environment variable OPENROUTER_API_KEY to your key and run bun http_server.ts. The server starts on port 3005, providing /tools and /attack endpoints.

What transport does the MCP server use?

The README does not specify the transport protocol. It only mentions that the client launches the server automatically.

Can I run this without an API key?

Yes, the MCP server and client demo (bun mcp_client.ts) does not require an API key. The HTTP server with LLM integration requires an OpenRouter API key.