🧠 Model Context Protocol (MCP) - Server-Client Implementation
About
This is a basic MCP Server-Client Impl using SSE
Explore
- FastAPI-based server and client with SSE transport
- Two defined tools: upload_claim and get_claim_details
- Client endpoints mirror server tools for easy invocation
- Simple in‑memory data storage (resets on restart)
- Minimal prototype suitable for learning or experimentation
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
🧠 Model Context Protocol (MCP) - Server-Client ImplementationCommand (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
cd server
pip install -r requirements.txt
python main.py
---
cd client
pip install -r requirements.txt
python main.py
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udde0 model context protocol (mcp) - server-client implementation": {
"mcp_server_client_impl": {
"command": "python",
"args": [
"main.py"
]
}
}
}
}McpServers
{
"mcp_server_client_impl": {
"command": "python",
"args": [
"main.py"
]
}
}This project is a simple Model Context Protocol (MCP) system that includes an MCP Server and a MCP Client, communicating via Server-Sent Events (SSE) using FastAPI. It demonstrates lightweight tool invocation using SSE over HTTP.
---
🏗️ Architecture Overview
+-------------+ SSE HTTP +-------------+
| | <------------------------------------> | |
| MCP CLIENT | | MCP SERVER |
| (FastAPI) | /upload_claim ⇄ upload_claim | (SSE Tools) |
| Port: 5000 | /get_claim_details ⇄ get_claim_details | Port: 8000 |
+-------------+ +-------------+
---
📁 Project Structure
.
├── client/ # MCP Client (FastAPI app)
│ └──main.py
│
├── server/ # MCP Server with SSE tools
│ └──main.py
|
└── README.md
└── requirements.txt
---
🔧 MCP Server
- Port: 8000
- Framework: FastAPI
- Protocol: Server-Sent Events (SSE)
- Defined Tools:
- upload_claim
- get_claim_details
▶️ Running the MCP Server
cd server
pip install -r requirements.txt
python main.py
---
🚀 MCP Client
- Port: 5000
- Framework: FastAPI
- Endpoints:
- POST /upload_claim → Calls upload_claim tool on the MCP Server
- GET /get_claim_details → Calls get_claim_details tool on the MCP Server
▶️ Running the MCP Client
cd client
pip install -r requirements.txt
python main.py
---
🔄 Communication Flow
1. Client sends an SSE HTTP request to the MCP Server to invoke a tool.
2. Server processes the request and streams the response back via SSE.
---
📬 Sample Requests
POST /upload_claim
curl -X POST http://localhost:5000/upload_claim \
-H "Content-Type: application/json" \
-d '{
"emp_id": "12345",
"claim": "This is a dummy claim!"
}'
POST /get_claim_details
curl -X POST http://localhost:5000/get_claim_details \
-H "Content-Type: application/json" \
-d '{
"claim_id": "12345"
}'
🧰 Requirements
> Python 3.10+
requirements.txt`
"mcp[cli]"
fastapi
httpx
Install dependencies in each directory using:
pip install -r requirements.txt
---
⚠️ Notes
- This is a minimal prototype intended for development or educational use.
- Data is stored in-memory and will reset on server restart.
- SSE is used for simplicity and streaming compatibility.
---
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
