MCPServerDemo
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCPServerDemo multiply 12 by 8"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JSON RPC Server with FastAPI and Python
This project implements a simple JSON-RPC server using FastAPI, Uvicorn, and jsonrpcserver in Python. It exposes add and multiply methods.
Setup
Clone the repository:
git clone <your-repo-url> cd json-rpc-serverCreate a virtual environment and install dependencies using
uv:uv venv .\.venv\Scripts\activate # On Windows # source .venv/bin/activate # On Linux/macOS uv pip install fastapi uvicorn jsonrpcserver
Related MCP server: FastAPI MCP Demo Server
Running the Server
To start the development server with auto-reloading:
.\.venv\Scripts\activate # On Windows
# source .venv/bin/activate # On Linux/macOS
uv run python -m uvicorn main:app --reloadThe server will run at http://127.0.0.1:8000/.
API Endpoints
GET /
A simple test endpoint to confirm the server is running.
Request:
# Using curl (Linux/macOS/Git Bash)
curl http://127.0.0.1:8000/
# Using Invoke-RestMethod (PowerShell)
Invoke-RestMethod -Uri "http://127.0.0.1:8000/" -Method GetResponse:
{
"message": "FastAPI is running!"
}POST / (JSON-RPC 2.0)
This is the main JSON-RPC endpoint for add and multiply methods.
Add Method
Request:
# Using curl
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "add", "params": [2, 3], "id": 1}' http://127.0.0.1:8000/
# Using Invoke-RestMethod (PowerShell)
Invoke-RestMethod -Uri "http://127.0.0.1:8000/" -Method Post -Headers @{ "Content-Type" = "application/json" } -Body '{"jsonrpc":"2.0","method":"add","params":[2,3],"id":1}'Response (Example):
{"jsonrpc": "2.0", "result": 5, "id": 1}Multiply Method
Request:
# Using curl
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "multiply", "params": [4, 5], "id": 1}' http://127.0.0.1:8000/
# Using Invoke-RestMethod (PowerShell)
Invoke-RestMethod -Uri "http://127.0.0.1:8000/" -Method Post -Headers @{ "Content-Type" = "application/json" } -Body '{"jsonrpc":"2.0","method":"multiply","params":[4,5],"id":1}'Response (Example):
{"jsonrpc": "2.0", "result": 20, "id": 1}Multipl Methods in a sigal call
curl -X POST -H "Content-Type: application/json" -d '[{"jsonrpc": "2.0", "method": "add", "params": [2, 3], "id": 1},{"jsonrpc": "2.0", "method": "multiply", "params": [2, 30], "id": 2}]' http://127.0.0.1:8000/
Invoke-RestMethod -Uri "http://127.0.0.1:8000/" -Method Post -Headers @{ "Content-Type" = "application/json" } -Body '[{"jsonrpc":"2.0","method":"add","params":[2,3],"id":1},{"jsonrpc":"2.0","method":"multiply","params":[2,30],"id":2}]'Install fastmcp
uv add fastmcpRun MCP inspector
uv run fastmcp dev inspector TestMPCserver.py Run MCP server
uv run fastmcp run TestMPCserver.pyConnect to cluade-desktop
uv run fastmcp install claude-desktop TestMPCserver.pyRun MCP server
uv run fastmcp run DataprovidersMCPServer.pyConnect to cluade-desktop
uv run fastmcp install claude-desktop DataprovidersMCPServer.pyuv add langchain langchain-openai langchain-mcp-adapters python-dotenv streamlit logging pandas fastmcp python-dotenv jsonrpcserver uvicorn streamlit langchain-ollama fastapi uvicorn serversendevent:app uvicorn Streamable:appStreaming HTTP Demo
This project includes a streaming HTTP endpoint demonstration using FastAPI's StreamingResponse.
Start the Stream Server
uv run uvicorn Streamable:app --reloadThe server will run at http://127.0.0.1:8000/stream and sends 10 chunks with 1-second intervals.
Run the Stream Client
python StreamableClient.pyThe client demonstrates both async and synchronous methods to consume the streaming response.
Test with curl
# Using curl (Linux/macOS/Git Bash)
curl http://127.0.0.1:8000/stream
# Using Invoke-RestMethod (PowerShell)
Invoke-RestMethod -Uri "http://127.0.0.1:8000/stream" -Method GetVS Code Debugging
A launch.json file is provided in the .vscode directory to enable debugging with VS Code. You can set breakpoints in main.py and run the "Python: FastAPI" configuration.
Available Tools
1 tooladdB
add two numbers
Inputs: a (required), b (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'add' has a clear and distinct purpose of adding two numbers, leaving no room for confusion or misselection by an agent.
Since there is only one tool named 'add', naming consistency is inherently perfect. There are no other tools to compare against, so no inconsistencies in patterns, styles, or conventions can arise.
A single tool is too few for most server purposes, as it severely limits functionality and scope. For a server named 'MCPServerDemo', which suggests a broader demonstration or utility set, one tool feels thin and inadequate, indicating a likely mismatch with the intended scope.
The tool surface is severely incomplete, as it only covers a basic arithmetic operation (adding two numbers) with no other related operations like subtraction, multiplication, or division. This leaves significant gaps for any practical use case, making it impossible to handle a full range of tasks in the implied domain of mathematical or utility functions.
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA demonstration MCP server that provides calculator functionality through both stdio and FastAPI implementations. Enables users to perform mathematical calculations via MCP tools using the FastMCP framework.-
- FlicenseNot gradedqualityDmaintenanceA demonstration MCP server built with FastAPI that provides basic mathematical operations and greeting services. Integrates with Gemini CLI to showcase MCP protocol implementation with simple REST endpoints.-
- FlicenseNot gradedqualityDmaintenanceA simple demonstration MCP server built with FastMCP that exposes basic calculator operations (add, subtract, multiply, divide) as tools for MCP clients like GitHub Copilot Agent mode.-
- FlicenseNot gradedqualityDmaintenanceA sample MCP server that provides basic arithmetic tools like addition, subtraction, multiplication, and division. It serves as a demonstration for implementing the Model Context Protocol and connecting custom tools to clients like Claude Desktop.-