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サーフェスであり、ヘルプリソースはエージェント向けの段階的な開示ワークフローガイダンスを提供します。

機能

• 永続的なマルチリポジトリワークスペース

• 管理者制御のリポジトリアローワリスト

• Git操作用のGitHub PAT認証

• ストリーミングHTTPトランスポート

• ファイル読み取り、行範囲読み取り、書き込み、行編集、検索、パッチ

• Gitステータス、差分、履歴、ブランチ、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