MCP HubMCP Hub
danwritecode

mcp-client-server-host-demo

by: danwritecode

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

37created 07/03/2025
Visit
pokemon
demo

📌Overview

Purpose: To demonstrate the integration of the Model Context Protocol (MCP) with Pokemon data, showcasing functionality for data retrieval and interaction through a client-server architecture.

Overview: This project features a comprehensive MCP setup that includes both a server and a client, enabling users to access and interact with Pokemon data and functionalities. It also incorporates an HTTP server to facilitate interoperability with large language models (LLMs) via OpenRouter, thus enhancing usability and integration.

Key Features:

  • MCP Server: Provides access to Pokemon data and attack capabilities, enabling the retrieval and manipulation of game features through a structured protocol.

  • MCP Client: Facilitates interaction with the MCP server, streamlining operations for users and allowing seamless data exchanges.

  • HTTP Server for LLM Integration: Allows LLMs to utilize Pokemon tools through an accessible HTTP interface, enabling functions like listing available tools and executing Pokemon attacks.

Pokemon MCP Demo

A demo project showcasing the integration of the Model Context Protocol (MCP) with Pokemon data.

Features

  • MCP server providing Pokemon data and attack capabilities
  • MCP client for server interaction
  • HTTP server for LLM usage via OpenRouter

Installation

bun install

Running the Project

MCP Server and Client

Run the client to launch the MCP server:

bun mcp_client.ts

HTTP Server with LLM Integration

Set your OpenRouter API key and run the HTTP server:

export OPENROUTER_API_KEY=your_api_key_here
bun http_server.ts

Access the server at http://localhost:3005:

  • /tools - List available tools
  • /attack - Execute a random Pokemon attack using LLM

This project uses Bun as its JavaScript runtime.