mcp-server-and-agent

상태: 작업 진행 중. 골격만 잡혀 있고, 아직 구현되지 않았습니다. 첫 결과가 나오면 이 README에 생성된 숫자가 채워질 예정입니다.

프로토콜 수준에서 직접 작성한 MCP 서버와, 그 위에서 동작하는 LangGraph 에이전트를 기반으로, 동일한 태스크 세트에 네 가지 토폴로지를 실행해 각각의 실패 모드를 측정합니다.

이 저장소는 한 가지 질문에 답합니다:

각 에이전트 토폴로지의 실패율은 얼마인가, 그리고 supervisor와 single-agent 가운데 정말 supervisor가 이기는가?

여기에 담긴 모든 것은 그 질문에 답하기 위해 존재합니다. 답에 도움이 되지 않는 기능은 범위 밖입니다 — 의도적으로 말입니다.

이 저장소가 존재하는 이유

목표

uv sync --extra dev
uv run pytest -q
uv run python scripts/generate_results.py

결과

아직 결과가 없습니다.

설계 결정

한계

다루는 개념

• 2C 직접 작성한 MCP 서버와 LangGraph 에이전트 (DO-8)

• 2C ReAct, plan-and-execute, reflection

• 2C 토폴로지 및 그 실패 모드

• 2C 도구 설계: 스키마 명확성, 세밀도(granularity), 오류를 모델 피드백으로 활용하기, 멱등성, 확인 게이트(confirmation gate)

• 2C 프로토콜로서의 MCP: 전송(transports), 발견(discovery), 리소스, 프롬프트, 샘플링, OAuth 범위(scope)

• 2C 상태(state)와 메모리(memory), 체크포인팅(checkpointing), 지속 실행(durable execution)

• …그 외 4개 더 (참조: docs/inventory-coverage.md)

라이선스

MIT