Optimized Memory MCP Server V2

최적화된 메모리 MCP 서버 v2

Claude Desktop 통합에 최적화된 고성능 Python 기반 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 효율적인 메모리 관리와 강력한 인프라 구성 요소 추적 기능을 제공합니다.

[!주의] 이 프로젝트는 잘못된 프로젝트 사양과 AI 방향으로 인해 끝없는 반복 동작이 발생하여 보관되었습니다.

개요

이 MCP 서버 구현은 다음에 중점을 둡니다.

• 대규모 인프라 추적을 위한 효율적인 메모리 관리
• MCP 패턴을 따르는 포괄적인 리소스 및 도구 구현
• Claude Desktop과의 완벽한 호환성
• 연결 풀링을 갖춘 SQLite 기반 영구 저장소
• 강력한 오류 처리 및 리소스 정리

특징

• MCP 리소스
  • 엔티티 관리(목록, 검색, 관계)
  • 공급자 리소스 추적
  • Ansible 컬렉션 관리
  • 버전 추적
  • 전체 텍스트 검색 기능
• MCP 도구
  • 엔터티 생성 및 관리
  • 관찰 추적
  • 공급자 등록
  • Ansible 모듈 통합
  • 인프라 분석 도구
• 핵심 구성 요소
  • FastMCP 서버 구현
  • 연결 풀링을 사용한 SQLite 데이터베이스
  • 포괄적인 오류 처리
  • 자동 리소스 정리
  • 광범위한 로깅

프로젝트 구조

지엑스피1

요구 사항

• Python 3.13.1 이상
• SQLite 3.x
• uvx 서버

빠른 시작

자세한 설치 지침은 환경 설정 가이드를 참조하세요.

주요 단계:

1. Python 환경 복제 및 설정
2. 종속성 설치: pip install -r requirements.txt
3. 데이터베이스 구성: export DATABASE_URL=sqlite:///path/to/db.db
4. 데이터베이스 초기화: alembic upgrade head
5. 서버 시작: uvx run python -m src.main

용법

1. 서버를 시작합니다:
   uvx run python -m src.main
2. Claude Desktop 구성:
   • MCP 서버 URL을 http://localhost:8000 으로 설정합니다.
   • Claude 설정에서 MCP 프로토콜 활성화
3. 연결 확인:
   curl http://localhost:8000/health

개발 설정

1. 개발 종속성 설치:
   pip install -r requirements-dev.txt
2. 사전 커밋 후크 설정:
   pre-commit install
3. 테스트 실행:
   pytest
4. 코드 품질 확인:
   flake8 mypy .

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치 생성
3. 우리의 규칙에 따라 변경하세요
4. 테스트 실행 및 린팅
5. 풀 리퀘스트 제출

선적 서류 비치

• 환경 설정 가이드 - 설치 및 구성
• MCP 사용 가이드 - MCP 리소스 및 도구 사용
• API 문서 - API 참조
• 구성 가이드 - 서버 구성
• 개발 가이드 - 기여 가이드라인
• 데이터베이스 스키마 - 데이터 모델 참조
• 문제 해결 가이드 - 일반적인 문제 및 해결 방법

특허

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

감사의 말

• MCP 프로토콜 사양을 위한 Claude Desktop 팀
• FastMCP 라이브러리에 기여한 사람들
• 데이터베이스 툴링을 위한 SQLAlchemy 팀