personal-repo-mcp

AI 에이전트를 위한 자체 호스팅, 다중 저장소 MCP 서버입니다. 에이전트에게 자체 VPS에 영구적인 Git 작업 공간을 제공하며, 관리자가 승인한 저장소에 대한 통제된 읽기/쓰기 액세스와 일반적인 Git 작업을 지원합니다.

버전 1.0.0 — MVP

핵심 아이디어

관리자는 에이전트가 액세스할 수 있는 저장소를 통제합니다. 에이전트는 허용된 저장소 중 실제로 클론할 저장소를 결정합니다.

Administrator
    |
    | mcp-config add repo jsilvanus/*
    v
repositories.json (allow-list)
    |
    v
MCP server
    |
    +-- clone_repository("jsilvanus/project")
    |
    v
persistent workspace

Related MCP server: GitLab MR MCP

MCP 도움말 리소스

서버는 모듈식 MCP 네이티브 운영 문서를 제공합니다. 다음부터 시작하세요:

mcp://help/index

초점을 맞춘 주제는 다음에서 확인할 수 있습니다:

mcp://help/repositories
mcp://help/files
mcp://help/git
mcp://help/chain-command
mcp://help/resources

도움말 리소스는 tools/list와 의도적으로 분리되어 있습니다. MCP 도구 목록은 권위 있는 API 표면으로 남아 있으며, 도움말 리소스는 에이전트를 위한 점진적 공개(progressive-disclosure) 워크플로우 안내를 제공합니다.

기능

• 영구적인 다중 저장소 작업 공간

• 관리자 통제 저장소 허용 목록

• Git 작업을 위한 GitHub PAT 인증

• 스트리밍 가능한 HTTP 전송

• 파일 읽기, 줄 범위 읽기, 쓰기, 줄 편집, 검색 및 패치

• Git 상태, diff, 기록, 브랜치, fetch/pull/push, merge/rebase 및 충돌 처리

• 작업 구성을 위한 단일 저장소 chain_command

• 시스템, 저장소, Git 및 개별 파일 상태에 대한 MCP 리소스

• 리소스 구독 및 변경 알림

• MCP 출력에서 비밀 정보 제거

• Git 서브모듈 보호 장치

• Docker 배포

배포

mcp-config로 호스트를 구성한 다음 단일 Docker 배포를 시작하세요:

mcp-config pat
mcp-config add repo jsilvanus/*
docker compose up -d --build

mcp-config add repo는 관리자 허용 목록만 변경합니다. 에이전트는 필요할 때 MCP를 통해 허용된 저장소를 클론합니다.

영구 저장소, 자격 증명, HTTPS 및 구성에 대한 자세한 내용은 docs/의 배포 문서를 참조하세요.

라이선스

EUPL-1.2