MCP Server Template
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., "@MCP Server Template reverse the string 'hello world'"
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.
MCP Server Template
A minimal MCP (Model Context Protocol) server template managed with uv, exposing a string-reversal tool and basic two-integer arithmetic tools (add, subtract, multiply, divide).
π Feature
uvfor dependency managementTOML + Pydantic based config
reverse_stringtooladd/subtract/multiply/dividetoolsCentralized logging (loguru)
Custom exception handling
Standalone stdio client for manual testing
Related MCP server: DDG MCP1234
π Project Structure
The directory structure of the project looks like this:
βββ LICENSE
βββ Makefile
βββ README.md
βββ client.py
βββ main.py
βββ configs
β βββ config.toml
βββ outputs
βββ pyproject.toml
βββ src
βββ __init__.py
βββ app.py
βββ server
β βββ __init__.py
β βββ server.py
βββ utils
βββ __init__.py
βββ config.py
βββ exceptions.py
βββ logger.py
βββ models.pyπ Getting Started
Step 1: Install dependencies
uv syncStep 2: Run the server
uv run python main.py
# or
make runThe server communicates over stdio and is meant to be launched by an MCP client (see Step 3), not run standalone in a terminal.
Step 3: Try it with the bundled client
uv run python client.py
# or
make clientThis spawns main.py as a subprocess over stdio, lists the available tools, then prompts you to try reverse_string and the arithmetic tools.
Step 4 (optional): Inspect it with the MCP Inspector
uv run mcp dev main.py:mcpOpens a browser UI to browse and call the registered tools interactively. main.py exposes a lazily-built mcp attribute for this purpose (see __getattr__ at the bottom of the file) β normal runs via make run / make client don't trigger it.
π References
Available Tools
5 toolsaddB
Add two integers
Inputs: a (required), b (required). Returns: result
divideB
Divide the first integer by the second
Inputs: a (required), b (required). Returns: result
multiplyB
Multiply two integers
Inputs: a (required), b (required). Returns: result
reverse_stringA
Reverse a given string
Inputs: text (required). Returns: result
subtractA
Subtract the second integer from the first
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 5 tools
Each tool has a clear, distinct purpose: four basic arithmetic operations on integers and one string reversal. There is no overlap in functionality.
All tool names are verbs or verb_noun in lowercase with underscores where needed, following a consistent pattern (e.g., add, divide, reverse_string).
With 5 tools, the count is well within the ideal range (3-15) and each tool serves a distinct function.
The arithmetic operations are basic but missing common ones like modulo or power. The single string operation feels isolated and incomplete without other string utilities.
Maintenance
Related MCP Connectors
Math MCP server for primality, factorization, Java templates, and integer multiplication.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA demonstration MCP server that provides basic utility tools including hello world functionality and string reversal operations. Shows how to build and deploy MCP tools using the MCPO orchestrator framework.GPL 3.0
- -licenseNot gradedqualityNot gradedmaintenanceA basic MCP server template with example tools for echoing messages and retrieving server information. Built with FastMCP framework and supports both stdio and HTTP transports.-
- -licenseNot gradedqualityNot gradedmaintenanceA basic MCP server template with example tools for echoing messages and retrieving server information. Built with FastMCP framework and supports both stdio and HTTP transports.-
- -licenseNot gradedqualityNot gradedmaintenanceA basic MCP server template with example tools for echoing messages and retrieving server information. Built with FastMCP framework and supports both stdio and HTTP transports.-