Skip to main content
Glama
mcp-agent-kit
by hummbl-dev

mcp-agent-kit

Python Version Runtime Dependencies Protocol License

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

mcp-agent-kit

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

stdio + SSE

stdio + SSE


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/list with automatic JSON schema generation.

  • Robust Error Boundaries: tools/call isolates 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 pytest test 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 tools
add_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

    A3.8/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools follow the same verb_noun snake_case pattern: add_numbers and get_system_info. Naming is predictable and consistent.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
      1
      37
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A dead simple MCP server for exposing your app functions to AI agents like Claude Desktop.
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables building and running MCP servers over streamable HTTP, exposing tools to AI assistants like Cursor, with examples of mounting multiple servers in FastAPI.
      -