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).

• 🔒 엔터프라이즈 준비 완료: 패키지 취약점 노출이 전혀 없어 즉시 감사 가능.

• ⚡ 초경량: 1밀리초 미만의 시작 시간으로 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% 통과.

• 의존성: 런타임 의존성 0개.

• 저자: Reuben Bowlby — LinkedIn | 이력서

엔터프라이즈 확장

mcp-agent-kit은 HUMMBL 개발자 생태계의 일부입니다. 엔터프라이즈급 멀티 에이전트 거버넌스(4단계 킬 스위치, HMAC 서명 위임 토큰, 암호화 감사 버스)를 원하신다면 **github.com/hummbl-io**를 방문하세요.