Skip to main content
Glama

MCP Agent Toolkit πŸ› οΈ

License: MIT Python 3.9+ Model Context Protocol

A modular, lightweight Python implementation of the Model Context Protocol (MCP) specification. Enables developers to rapidly build, test, and deploy custom tool-calling servers and sandboxed execution environments for AI agents (Cursor, Anthropic Claude, LangChain, AutoGen).


🌟 Key Features

  • JSON-RPC 2.0 Compliant: Full implementation of MCP protocol methods (initialize, tools/list, tools/call).

  • Zero Heavy Dependencies: Pure Python standard library implementation with zero external baggage.

  • Sandboxed Filesystem Tool: Path traversal-proof file operations confined strictly to an isolated root directory.

  • Agent Scratchpad & Memory Store: In-memory key-value state and audit trail logging for long-running workflows.

  • Plug-and-Play Extensibility: Decorate or register any Python function as an MCP tool with schema validation in seconds.


Related MCP server: MCPort

πŸš€ Quickstart

1. Register Tools & Run Server

from mcp_agent_toolkit import MCPServer, MCPClient

# Initialize MCP Server
server = MCPServer(name="calculator-agent", version="1.0.0")

# Register custom tool
server.register_tool(
    name="multiply",
    description="Multiplies two numbers",
    parameters={
        "type": "object",
        "properties": {
            "x": {"type": "number"},
            "y": {"type": "number"}
        },
        "required": ["x", "y"]
    },
    handler=lambda x, y: x * y
)

# Connect Client
client = MCPClient(server)
result = client.execute_tool("multiply", x=6, y=7)
print(result["content"][0]["text"])  # Output: 42

2. Sandboxed File Operations

from mcp_agent_toolkit import SandboxedFilesystemTool

fs = SandboxedFilesystemTool(sandbox_root="./agent_workspace")
fs.write_file("notes.txt", "Autonomous agent task plan.")
content = fs.read_file("notes.txt")

πŸ§ͺ Running Tests

python -m unittest discover tests

πŸ“„ License

Released under the MIT License. Built with clean architecture principles by Milind Chatrabhuji.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides a secure, constrained filesystem workspace for LLM agents to manage files, notes, and code artifacts via stdio or remote HTTP. It features granular access controls, including extension whitelisting, storage quotas, and immutable paths for safe automated file operations.
      BSD 3-Clause
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to safely read, search, understand, and edit local project code and files, with Git inspection, code indexing, and controlled command execution within permissioned workspaces.
      8 npm
      6
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI clients to perform sandboxed filesystem, directory, Ubuntu system, network, git, and code/text operations through 38 typed tools confined to a workspace. Ships with a browser-based web console that provides an interactive Linux terminal, a live tool playground, and real-time CPU, memory, and disk monitoring.
      38
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to securely inspect, modify, and manage local projects with trusted filesystem access, safe Git operations, controlled task execution, and developer runtime process management over stdio or HTTP.
      4
      Apache 2.0