mcp-agent-kit
This server exposes two MCP tools for basic arithmetic and system introspection.
add_numbers: Add two numbers (
aandb) together and get the sum.get_system_info: Retrieve host system architecture and OS details (no arguments required).
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-agent-kit create a simple MCP server that exposes a Python function as a tool"
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-agent-kit
A pure standard-library Model Context Protocol (MCP) server & tool harness for Claude Desktop, Cursor, and autonomous agent fleets.
Quickstart • Architecture • Claude Desktop Setup • Comparison • Engineering Rigor
Architecture
Related MCP server: MCP-123
Why mcp-agent-kit?
The official MCP SDKs introduce dozens of heavy third-party dependencies (pydantic, anyio, httpx, starlette), creating unnecessary supply-chain attack surfaces and installation friction in enterprise environments.
mcp-agent-kit provides a complete, production-ready implementation of the Model Context Protocol using 100% Python Standard Library:
🚀 Zero Runtime Dependencies: Pure Python (
json,sys,inspect,dataclasses).🔒 Enterprise-Ready: Instant auditability with zero package vulnerability exposure.
⚡ Ultra Lightweight: <5MB package memory overhead with no dependency resolution delay, ideal for CLI tools, serverless environments, and embedded forward-deployed agent integrations.
🛠️ Automatic Schema Generation: Infers JSON Schema definitions directly from native Python type hints and docstrings.
mcp-agent-kit vs Official MCP SDK
Dimension |
| Official Python MCP SDK |
Runtime Dependencies | 0 (Python stdlib only) | 18+ third-party dependencies |
Installed Package Size | ~15 KB | ~42 MB (with transitive dependencies) |
Process Startup Time | < 1.2 ms | ~120 ms |
Audit Surface Area | Single file / Zero CVEs | Multiple supply-chain dependencies |
Transport Support |
|
|
Quickstart
1. Build an MCP Server in 20 Lines
from mcp_agent_kit import MCPServer
app = MCPServer(name="my-agent-tools", version="1.0.0")
@app.tool(description="Calculate tax and total invoice amounts")
def calculate_invoice(subtotal: float, tax_rate: float = 0.07) -> dict:
tax = round(subtotal * tax_rate, 2)
return {"subtotal": subtotal, "tax": tax, "total": round(subtotal + tax, 2)}
if __name__ == "__main__":
app.run_stdio()Claude Desktop Integration
Add your server directly to claude_desktop_config.json:
{
"mcpServers": {
"my-tools": {
"command": "python",
"args": ["-m", "examples.simple_server"]
}
}
}Restart Claude Desktop, and your custom tools will immediately appear in Claude's tool belt! 🔨
Features
Full MCP Handshake:
initialize,notifications/initialized,ping.Dynamic Tool Discovery:
tools/listwith automatic JSON schema generation.Robust Error Boundaries:
tools/callisolates tool runtime exceptions and reports structured error messages back to the LLM without crashing the stdio process.Zero Dependencies: Runs out of the box on Python 3.10+.
Engineering Rigor & Verification
Tests: 100% passing
pytesttest suite covering initialization, tool discovery, argument validation, and exception handling.Dependencies: 0 runtime dependencies.
Author: Reuben Bowlby — LinkedIn | Resume
Enterprise Scale
mcp-agent-kit is part of the HUMMBL developer ecosystem. For enterprise-grade multi-agent governance (4-stage kill switches, HMAC-signed delegation tokens, and cryptographic audit buses), visit github.com/hummbl-io.
Available Tools
2 toolsadd_numbersA
Add two numbers together
Inputs: a (required), b (required).
get_system_infoA
Get host system architecture and OS details
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are completely unrelated in purpose: one performs arithmetic and the other retrieves system information. There is no possibility of an agent confusing them.
Both tools follow the same verb_noun snake_case pattern: add_numbers and get_system_info. Naming is predictable and consistent.
With only two tools, the server sits at the low end of the acceptable range. The name mcp-agent-kit suggests a broader toolkit, so two tools feel thin.
The two tools do not form a coherent domain, and the server name implies a general-purpose agent kit, yet almost no common agent capabilities are represented. There are significant gaps if this is meant to be a functional toolkit.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseDqualityDmaintenanceA foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.137MIT
- FlicenseNot gradedqualityDmaintenanceA minimal Python package for easily setting up and running MCP servers and clients, allowing functions to be automatically exposed as tools that LLMs can use with just 2 lines of code.22-
- AlicenseNot gradedqualityDmaintenanceA dead simple MCP server for exposing your app functions to AI agents like Claude Desktop.6MIT
- FlicenseNot gradedqualityDmaintenanceEnables building and running MCP servers over streamable HTTP, exposing tools to AI assistants like Cursor, with examples of mounting multiple servers in FastAPI.-