MCP Ping-Pong Server by Remote Call

1# 🏓 MCP Ping-Pong Server by Remote Call
2 
3An experimental and educational Ping-Pong server demonstrating MCP (Model Context Protocol) calls via FastAPI.
4 
5## Features
6 
7- ✅ FastAPI/FastMCP backend for remote MCP calls through API endpoints or SSE
8- 🔄 MCP integration for command handling
9- 🔐 Thread-safe session management
10 
11## Quick Start
12 
13### Installation
14 
15To install the dependencies, run:
16 
17```bash
18poetry install
19```
20 
21### 1. Call MCP Tool through API
22 
23#### Run the Server
24 
25Start the FastAPI server with:
26 
27```bash
28python mcp-api-server.py
29```
30 
31The server will start at `http://localhost:8080`.
32 
33#### UI
34 
35Open `mcp-api-client.html` in a browser to interact with the UI.
36 
37<img alt="ui" src="doc/pingpong-ui.png" width="400"/>
38 
39#### API Endpoints
40 
41- `GET /ping-pong?prompt_name=<prompt_name>`: Retrieves the specified prompt.
42- `POST /ping-pong`: Invokes MCP tool commands (`ping`, `pong`, `count`).
43 
44### 2. Call MCP Tool through SSE transport
45 
46The following example demonstrates using Server-Sent Events (SSE) for communication with the MCP server.
47 
48#### Run the SSE Server
49 
50```bash
51python mcp-sse-server.py
52```
53 
54#### Run the SSE Client
55 
56```bash
57python mcp-sse-client.py
58```
59 
60#### Sample Output
61 
62```bash
63Type a command (e.g., 'ping', 'pong', 'count') or 'exit' to quit:
64>>> ping
65Sending command: ping
66Result: pong
67>>> pong
68Sending command: pong
69Result: ping
70>>> count
71Sending command: count
72Result: 2
73```
74 
75## References
76 
77- [FastAPI SSE MCP](https://github.com/ragieai/fastapi-sse-mcp)
78- [MCP Weather SSE](https://github.com/justjoehere/mcp-weather-sse)
79- [MCP Chinese Getting Started Guide](https://github.com/liaokongVFX/MCP-Chinese-Getting-Started-Guide)
80 
81## 📄 License
82 
83MIT
84 
85