personal-repo-mcp

一个自托管的、多仓库 MCP 服务器，面向 AI 代理。它为代理在你的 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: Coding Tools 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