mcp-agent-kit

# mcp-agent-kit `mcp-agent-kit` is an enterprise-grade scaffolding kit and runtime foundation that enables developers to build, validate, and ship a fully compliant, production-ready Model Context Protocol (MCP) server with Agent-to-Agent (A2A) protocol support and portable Agent Skill (`SKILL.md`) packaging in under 30 minutes. Built entirely with the Python standard library for zero runtime dependencies in the protocol core, it enforces strict stateless MCP specification compliance (version 2026-07-28), deterministic resource listing, schema design validation, dual-era negotiation, and automated tool-to-skill card mapping. --- ## Quick Start (5 Lines) ```bash pip install mcp-agent-kit create-mcp-agent my_agent cd my_agent python validate.py python server.py ``` --- ## End-to-End Demo Walkthrough (with Real Outputs) Follow these step-by-step instructions to scaffold, validate, test, and run an MCP agent end-to-end. ### Step 1: Scaffold a New Agent Run the generator CLI to create a new agent (e.g. `demo_agent`): ```bash python -m mcp_agent_kit demo_agent --desc "Use when computing numerical metrics and data summaries. Do not use for unstructured text parsing." ``` **Terminal Output:** ```text Scaffolding MCP agent 'demo_agent' into 'demo_agent'... ✓ Agent 'demo_agent' successfully created in 'demo_agent'. Next steps: cd demo_agent python validate.py ``` --- ### Step 2: Run Compliance Validation Navigate into the agent directory and execute `validate.py`: ```bash cd demo_agent python validate.py ``` **Terminal Output:** ```text ✓ MCP server/discover responds correctly ✓ tools/list is deterministically ordered ✓ all tool schemas pass design rules ✓ A2A agent.json is valid ✓ SKILL.md portable core is valid ✓ dual-era client probe works against local server ``` --- ### Step 3: Run the Dual-Era Probe Client Test Verify client negotiation and tool execution via `client_test.py`: ```bash python client_test.py ``` **Terminal Output:** ```text .. -----…