mcp-agent-kit

Claude Desktop、Cursor、および自律エージェント群のための、標準ライブラリのみを使用した純粋なModel Context Protocol (MCP) サーバー＆ツールハーネス。

クイックスタート • アーキテクチャ • Claude Desktop セットアップ • 比較 • エンジニアリングの厳密性

アーキテクチャ

Related MCP server: MCP-123

なぜmcp-agent-kitなのか？

公式MCP SDKは、多数の重いサードパーティ依存関係（pydantic、anyio、httpx、starlette）を導入し、エンタープライズ環境において不要なサプライチェーン攻撃面とインストール時の摩擦を生み出します。

mcp-agent-kit は、100% Python標準ライブラリ を使用した、Model Context Protocolの完全かつ本番環境対応の実装を提供します：

• 🚀 ランタイム依存関係ゼロ: 純粋なPython（json、sys、inspect、dataclasses）。

• 🔒 エンタープライズ対応: パッケージの脆弱性曝露ゼロで、即時に監査可能。

• ⚡ 超軽量: サブミリ秒の起動時間。CLIツール、サーバーレス環境、組み込み型・前方展開型のエージェント統合に最適。

• 🛠️ 自動スキーマ生成: ネイティブなPython型ヒントとdocstringからJSON Schema定義を直接推論。

mcp-agent-kit vs 公式MCP SDK

クイックスタート

1. 20行でMCPサーバーを構築する

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 統合

サーバーを claude_desktop_config.json に直接追加します：

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["-m", "examples.simple_server"]
    }
  }
}

Claude Desktopを再起動すると、カスタムツールがすぐにClaudeのツールベルトに表示されます！ 🔨

機能

• 完全なMCPハンドシェイク: initialize、notifications/initialized、ping。

• 動的なツール検出: 自動JSONスキーマ生成を備えた tools/list。

• 堅牢なエラーバウンダリ: tools/call はツールの実行時例外を分離し、stdioプロセスをクラッシュさせることなく、構造化されたエラーメッセージをLLMに報告します。

• 依存関係ゼロ: Python 3.10+ でそのまま動作します。

エンジニアリングの厳密性と検証

• テスト: 初期化、ツール検出、引数検証、例外処理をカバーする pytest テストスイートが100%パス。

• 依存関係: ランタイム依存関係はゼロ。

• 著者: Reuben Bowlby — LinkedIn | 履歴書

エンタープライズスケール

mcp-agent-kit は、HUMMBL デベロッパーエコシステムの一部です。エンタープライズグレードのマルチエージェントガバナンス（4段階のキルスイッチ、HMAC署名付き委任トークン、暗号監査バス）については、github.com/hummbl-io をご覧ください。