에이전트 구성

"옷부터 장비, 무기, 훈련 시뮬레이션까지 필요한 건 뭐든지 실을 수 있어요." - 매트릭스(1999)

Agent Construct는 AI 애플리케이션이 도구와 컨텍스트에 접근하는 방식을 표준화하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 영화 매트릭스의 Construct가 운영자에게 필요한 모든 장비에 즉시 접근할 수 있도록 지원했던 것처럼, Agent Construct는 AI 모델이 MCP 사양을 통해 도구와 데이터에 접근할 수 있는 표준화된 인터페이스를 제공합니다.

모델 컨텍스트 프로토콜(Model Context Protocol) 사양을 기반으로 구축되어 AI 애플리케이션의 도구 검색, 실행 및 컨텍스트 관리를 관리하는 중앙 허브 역할을 합니다. 표준화된 프로토콜을 통해 AI 모델에 기능을 노출하는 강력하고 확장 가능한 방법을 제공합니다. 또한 간소화된 구성과 도구 구조를 제공하여 새로운 기능을 손쉽게 추가할 수 있도록 지원합니다! Gemini를 이용한 웹 검색 도구 예시도 포함되어 있습니다.

핵심 기능

MCP 프로토콜 구현

• 전체 MCP 규정 준수 : 모델 컨텍스트 프로토콜 사양의 완전한 구현
• 도구 검색 : 동적 도구 등록 및 검색 메커니즘
• 표준화된 커뮤니케이션 : 도구 상호 작용을 위한 MCP의 커뮤니케이션 패턴을 구현합니다.

서버 아키텍처

• FastAPI 백엔드 : 고성능 비동기 서버 구현
• 이벤트 스트리밍 : SSE(Server-Sent Events)를 통한 실시간 업데이트
• 모듈형 디자인 : 핵심 프로토콜 처리와 도구 구현 간의 명확한 분리
• 핸들러 시스템 : 다양한 MCP 작업을 위한 확장 가능한 요청 핸들러 아키텍처
• 도구 기반 속도 제한 : 서버가 구성 가능한 도구별 속도 제한을 처리하도록 합니다.

개발 특징

• 도구 장식 시스템 : MCP를 통해 새로운 도구를 노출하는 간단한 방법
• 로깅 및 모니터링 : 디버깅 및 모니터링을 위한 포괄적인 로깅 시스템
• 구성 관리 : 보안 기본값을 사용한 환경 기반 구성
• 테스트 프레임워크 : 프로토콜 준수를 위한 광범위한 테스트 모음
• 에이전트 프레임워크 친화적 : smolagents와 같은 사용자 정의 클라이언트나 프레임워크에 대한 구현 예가 포함되어 있습니다.

시작하기

필수 조건

• Python 3.8 이상
• pip 패키지 관리자

설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   pip install -r requirements.txt
3. 환경 변수 설정: 다음 변수가 포함된 루트 디렉토리에 .env 파일을 만듭니다.
   # Server Configuration SERVER_HOST=localhost SERVER_PORT=8000 # MCP Protocol Settings MCP_VERSION=1.0 TOOL_DISCOVERY_ENABLED=true # Security Settings ENABLE_AUTH=false # Enable for production
4. 서버를 실행합니다:
   python -m mcp_server

핵심 아키텍처

MCP 프로토콜 기능

도구 발견

• 동적 도구 등록 시스템
• 도구 기능 광고
• 버전 관리
• 도구 메타데이터 및 문서

컨텍스트 관리

• 효율적인 컨텍스트 저장 및 검색
• 컨텍스트 범위 및 격리
• 실시간 컨텍스트 업데이트
• 컨텍스트 지속성 옵션

커뮤니케이션 패턴

• 동기식 요청/응답
• 업데이트에 대한 서버 전송 이벤트
• 스트리밍 응답
• 오류 처리 및 복구

향후 개선 사항

프로토콜 확장

• [ ] 고급 컨텍스트 관리 기능
• [ ] 사용자 정의 프로토콜 확장
• [ ] 프로토콜 핸들러를 위한 플러그인 시스템

보안

• [ ] 인증 및 권한 부여
• [ ] 도구 접근 제어
• [-] 속도 제한 및 할당량 관리
• [ ] 감사 로깅
• [ ] 종단간 암호화

성능

• [ ] 도구 실행 최적화
• [ ] 컨텍스트 캐싱
• [ ] 부하 분산
• [ ] 요청 대기
• [ ] 자원 관리

개발

• [ ] 대화형 프로토콜 탐색기
• [ ] 도구 개발 SDK
• [ ] 프로토콜 준수 테스트 도구
• [ ] 성능 모니터링 대시보드

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 주요 변경 사항의 경우, 먼저 이슈를 열어 변경 사항을 논의해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• 프로토콜 사양을 위한 모델 컨텍스트 프로토콜
• 뛰어난 웹 프레임워크를 위한 FastAPI
• 이 프로젝트에서 사용되는 다양한 도구와 라이브러리를 위한 오픈 소스 커뮤니티