mcp-utils
@fulfilio
About mcp-utils
Python utilities to work with MCP servers
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-utils": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"mcp-proxy",
"--client",
"claude"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is mcp-utils?
mcp-utils is a Python utility package for building Model Context Protocol (MCP) servers, focused on synchronous implementations using Flask. It provides helpers, decorators, and Pydantic models for developers integrating MCP into existing Python applications without asynchronous code.
How to use mcp-utils?
Install with pip install mcp-utils. Create an MCPServer instance, decorate handlers with @mcp.tool() or @mcp.prompt(), and handle incoming requests via mcp.handle_message(). For production, deploy with Flask and Gunicorn.
Key features of mcp-utils
- Synchronous MCP server implementation
- Server-Sent Events (SSE) support
- Simple decorators for tools and prompts
- HTTP protocol with Streamable HTTP support
- Redis response queue for message handling
- Comprehensive Pydantic models for MCP schema
- Built-in validation and documentation
Use cases of mcp-utils
- Embedding MCP capabilities into existing Python web applications
- Building MCP servers with synchronous database transactions (e.g., SQLAlchemy)
- Deploying MCP servers with Gunicorn for production workloads
- Prototyping MCP tools and prompts without async complexity
FAQ from mcp-utils
What are the runtime dependencies?
Python 3.10+ and Pydantic 2 are required. Flask, Gunicorn, and Redis are optional for web server, production deployment, and response queuing respectively.
Does mcp-utils support asynchronous code?
No, mcp-utils is explicitly designed for synchronous implementations. For async MCP servers, consider the MCP Python SDK.
How do I connect Claude Desktop to an mcp-utils server?
Claude Desktop does not natively support SSE/HTTP; use mcp-proxy (installable via PyPI or Smithery) to bridge stdio with the server's SSE endpoint.
Can I use mcp-utils with Flask for production?
Yes, the README provides Flask examples with Streamable HTTP and optional SQLAlchemy transaction handling, plus a Gunicorn deployment example.
How can I test my MCP server built with mcp-utils?
Use the MCP Inspector (npm install -g @modelcontextprotocol/inspector) to open a web interface, point it to your server’s SSE URL, and send test messages.
Frequently asked questions
What are the runtime dependencies?
Python 3.10+ and Pydantic 2 are required. Flask, Gunicorn, and Redis are optional for web server, production deployment, and response queuing respectively.
Does mcp-utils support asynchronous code?
No, mcp-utils is explicitly designed for synchronous implementations. For async MCP servers, consider the MCP Python SDK.
How do I connect Claude Desktop to an mcp-utils server?
Claude Desktop does not natively support SSE/HTTP; use `mcp-proxy` (installable via PyPI or Smithery) to bridge stdio with the server's SSE endpoint.
Can I use mcp-utils with Flask for production?
Yes, the README provides Flask examples with Streamable HTTP and optional SQLAlchemy transaction handling, plus a Gunicorn deployment example.
How can I test my MCP server built with mcp-utils?
Use the MCP Inspector (`npm install -g @modelcontextprotocol/inspector`) to open a web interface, point it to your server’s SSE URL, and send test messages.
Basic information
More Other MCP servers
Codelf
unbugA search tool helps dev to solve the naming things problem.
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Comments