🏓 MCP Ping-Pong Server with FastAPI
About
🏓 An experimental and educational script for Ping-pong server demonstrating remote MCP (Model Context Protocol) calls
Details
- Author
- kimtth
- GitHub stars
- 2
- Downloads
- 252
- Categories
- Developer Tools
Jump to
- FastAPI/FastMCP backend for remote MCP calls.
- MCP integration for command handling (ping, pong, count).
- Thread-safe session management.
- API endpoints for GET (prompt retrieval) and POST (tool invocation).
- SSE transport support for real‑time communication.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🏓 MCP Ping-Pong Server with FastAPICommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies with poetry install. Run python mcp-api-server.py to start the FastAPI server on http://localhost:8080 and open mcp-api-client.html in a browser for the UI, or use the API directly. For SSE transport, run python mcp-sse-server.py and then python mcp-sse-client.py to interact via the command line with commands like ping, pong, and count.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83c\udfd3 mcp ping-pong server with fastapi": {
"mcp-fastapi-ping-pong": {
"command": "python",
"args": [
"mcp-api-server.py"
]
}
}
}
}McpServers
{
"mcp-fastapi-ping-pong": {
"command": "python",
"args": [
"mcp-api-server.py"
]
}
}🏓 MCP Ping-Pong Server by Remote Call
An experimental and educational Ping-Pong server demonstrating MCP (Model Context Protocol) calls via FastAPI.
Features
- ✅ FastAPI/FastMCP backend for remote MCP calls through API endpoints or SSE
- 🔄 MCP integration for command handling
- 🔐 Thread-safe session management
Quick Start
Installation
To install the dependencies, run:
poetry install
1. Call MCP Tool through API
Run the Server
Start the FastAPI server with:
python mcp-api-server.py
The server will start at http://localhost:8080.
UI
Open mcp-api-client.html in a browser to interact with the UI.
API Endpoints
- GET /ping-pong?prompt_name=<prompt_name>: Retrieves the specified prompt.
- POST /ping-pong: Invokes MCP tool commands (ping, pong, count).
2. Call MCP Tool through SSE transport
The following example demonstrates using Server-Sent Events (SSE) for communication with the MCP server.
Run the SSE Server
python mcp-sse-server.py
Run the SSE Client
python mcp-sse-client.py
Sample Output
Type a command (e.g., 'ping', 'pong', 'count') or 'exit' to quit:
>>> ping
Sending command: ping
Result: pong
>>> pong
Sending command: pong
Result: ping
>>> count
Sending command: count
Result: 2
References
- FastAPI SSE MCP
- MCP Weather SSE
- MCP Chinese Getting Started Guide
📄 License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
