🏓 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:

bash

poetry install

1. Call MCP Tool through API

Run the Server

Start the FastAPI server with:

bash

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

bash

python mcp-sse-server.py

Run the SSE Client

bash

python mcp-sse-client.py

Sample Output

bash

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

📄 License

MIT