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
10.4K
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
10.9K
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
9.0K
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.5K
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
10.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
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
27.8K
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
19.7K
4.3 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.3K
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
56.4K
4.3 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.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
53.5K
4.5 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
37.7K
4.8 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
18.3K
4.5 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase