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 install1. Call MCP Tool through API
Run the Server
Start the FastAPI server with:
python mcp-api-server.pyThe 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.pyRun the SSE Client
python mcp-sse-client.pySample 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: 2References
📄 License
MIT