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
8.7K

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

C
Claude Context
Claude Context is an MCP plugin that provides in - depth context of the entire codebase for AI programming assistants through semantic code search. It supports multiple embedding models and vector databases to achieve efficient code retrieval.
TypeScript
9.8K
5 points
A
Acemcp
Acemcp is an MCP server for codebase indexing and semantic search, supporting automatic incremental indexing, multi-encoding file processing, .gitignore integration, and a Web management interface, helping developers quickly search for and understand code context.
Python
11.1K
5 points
B
Blueprint MCP
Blueprint MCP is a chart generation tool based on the Arcade ecosystem. It uses technologies such as Nano Banana Pro to automatically generate visual charts such as architecture diagrams and flowcharts by analyzing codebases and system architectures, helping developers understand complex systems.
Python
8.1K
4 points
M
MCP Agent Mail
MCP Agent Mail is a mail - based coordination layer designed for AI programming agents, providing identity management, message sending and receiving, file reservation, and search functions, supporting asynchronous collaboration and conflict avoidance among multiple agents.
Python
9.6K
5 points
M
MCP
The Microsoft official MCP server provides search and access functions for the latest Microsoft technical documentation for AI assistants
12.7K
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
9.2K
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
10.4K
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
11.6K
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
18.4K
4.5 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
28.1K
5 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
18.8K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
57.7K
4.3 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
52.8K
4.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#
25.4K
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
79.0K
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
38.0K
4.8 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase