MCP Client Server Host Demo
M

MCP Client Server Host Demo

A demonstration project showcasing the combination of the Model Context Protocol (MCP) with Pokemon data, including an MCP server, a client, and an HTTP server that allows LLMs to call Pokemon tools via OpenRouter.
2.5 points
6.8K

What is the Pokemon MCP Demo?

This is a demonstration project that shows how to use the Model Context Protocol (MCP) to manage and interact with Pokemon data. The project includes an MCP server (providing Pokemon data and attack functions), an MCP client, and an HTTP server that allows LLMs to use Pokemon tools via OpenRouter.

How to use the Pokemon MCP Demo?

You can start the entire system by running the MCP client, or run the HTTP server separately to allow LLMs to access Pokemon tools. The system provides a simple command-line interface and an HTTP API.

Use cases

Suitable for developers who want to understand how the MCP protocol works, researchers interested in game data integration, and AI enthusiasts who want to explore the possibilities of LLM interaction with game systems.

Main features

MCP Server
The core service that provides Pokemon data and attack functions
MCP Client
A demonstration client that interacts with the MCP server
HTTP Server
Allows LLMs to access Pokemon tools via OpenRouter
OpenRouter Integration
Supports LLMs using Pokemon tools via the OpenRouter API
Advantages
Demonstrates the practical application of the MCP protocol
Provides a complete end-to-end example
Supports LLM access via a standard HTTP interface
Uses the Bun runtime for fast startup
Limitations
Currently only contains limited Pokemon data
The HTTP server has basic functionality
Requires an OpenRouter API key to use LLM features

How to Use

Install dependencies
Install project dependencies using the Bun package manager
Run the MCP client
Running the client will automatically start the MCP server
Run the HTTP server (optional)
Run the HTTP server after setting the OpenRouter API key
Access the HTTP interface
After the server is running, you can access the API endpoints via a browser or tool

Usage Examples

Get the list of Pokemon tools
Get the available Pokemon tools via the HTTP interface
Perform a random Pokemon attack
Let the LLM perform a random Pokemon attack via the HTTP interface
Use the MCP client directly
Interact with the server directly using the MCP client without going through the HTTP interface

Frequently Asked Questions

Why is an OpenRouter API key required?
Can the Pokemon data be extended?
What JavaScript runtime does this project use?
What is the MCP protocol?

Related Resources

Bun Official Documentation
Official documentation for the Bun JavaScript runtime
OpenRouter Website
Official website for the OpenRouter API
Pokemon API
A free Pokemon REST API
MCP Protocol Specification
Official specification document for the Model Context Protocol

Installation

Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

M
MCP
The Microsoft official MCP server provides search and access functions for the latest Microsoft technical documentation for AI assistants
10.6K
5 points
A
Aderyn
Aderyn is an open - source Solidity smart contract static analysis tool written in Rust, which helps developers and security researchers discover vulnerabilities in Solidity code. It supports Foundry and Hardhat projects, can generate reports in multiple formats, and provides a VSCode extension.
Rust
5.6K
5 points
D
Devtools Debugger MCP
The Node.js Debugger MCP server provides complete debugging capabilities based on the Chrome DevTools protocol, including breakpoint setting, stepping execution, variable inspection, and expression evaluation.
TypeScript
6.7K
4 points
S
Scrapling
Scrapling is an adaptive web scraping library that can automatically learn website changes and re - locate elements. It supports multiple scraping methods and AI integration, providing high - performance parsing and a developer - friendly experience.
Python
9.0K
5 points
M
Mcpjungle
MCPJungle is a self-hosted MCP gateway used to centrally manage and proxy multiple MCP servers, providing a unified tool access interface for AI agents.
Go
0
4.5 points
C
Cipher
Cipher is an open-source memory layer framework designed for programming AI agents. It integrates with various IDEs and AI coding assistants through the MCP protocol, providing core functions such as automatic memory generation, team memory sharing, and dual-system memory management.
TypeScript
0
5 points
N
Nexus
Nexus is an AI tool aggregation gateway that supports connecting multiple MCP servers and LLM providers, providing tool search, execution, and model routing functions through a unified endpoint, and supporting security authentication and rate limiting.
Rust
0
4 points
S
Shadcn Ui MCP Server
An MCP server that provides shadcn/ui component integration for AI workflows, supporting React, Svelte, and Vue frameworks. It includes functions for accessing component source code, examples, and metadata.
TypeScript
12.5K
5 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
15.2K
4.5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
47.8K
4.3 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
17.5K
4.3 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
25.7K
5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
21.2K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
47.4K
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
67.2K
4.7 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
31.2K
4.8 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase