yarMCP (Sunnamed434)

YARMCP

Y和 A.不同的 R欧洲专利局 主控程序 -自托管MCP服务器，将git repo克隆到您的服务器，让AI助手快速访问最新的源代码，而无需达到GitHub API限制或每个项目需要多个repo克隆。

](https://hub.docker.com/r/sunnamed434/yarmcp-mcp) ](https://hub.docker.com/r/sunnamed434/yarmcp-mcp) ](https://hub.docker.com/r/sunnamed434/yarmcp-mcp) 

用例

您正在使用AI（Claude Code、Cursor、Claude.AI web、ChatGPT、Copilot等），并想问： “最新的React Router v7如何处理数据加载？”

• ❌ 人工智能训练数据已有6-7个月的历史——表明API过时或进行网络搜索（速度慢，吃代币，并不总是准确）
• ❌ GitHub MCP工作正常，但很快达到5000个请求/小时的限制
• ✅ YARMCP：直接服务器访问，无速率限制，始终保持最新，无需网络搜索

你使用10多个repos（React、TypeScript、TailwindCSS等）和命中率限制：

• ❌ GitHub MCP:5000个请求/小时共享-很快用完
• ❌ git-mcp:仍然达到GitHub API的限制
• ✅ YARMCP：零速率限制，从服务器存储读取

你希望AI在各个项目中引用官方源代码：

选项1：创建 /repos PC上包含所有克隆的文件夹

• ❌ 10个存储库×500MB=5GB磁盘空间
• ❌ 必须手动 git pull 保持更新
• ❌ 切换PC？重新启动或设置服务器同步

选项2：将存储库克隆到项目目录中

• ❌ 你的 .git 文件夹变大（如果太大，GitHub可能会拒绝推送）
• ❌ 增添 .gitignore？每个团队成员必须在本地手动克隆这些存储库
• ❌ 团队成员版本不同——不一致

选项3：使用YARMCP

• ✅ 一台服务器，所有项目访问相同的存储库（无重复）
• ✅ 每6小时自动更新一次（可配置）
• ✅ 浅层克隆(--depth=1)根据回购历史记录节省30-95%的空间
• ✅ 适用于任何PC、浏览器或IDE，只需连接到服务器即可
• ✅ 支持私有仓库（GitHub PAT或SSH密钥）

是什么让YARMCP与众不同？

智能错误处理：

• 找不到文件建议 -当路径不存在时显示类似文件
• 目录预览 -显示前3项以减少勘探步骤
• 树视图工具 -带Unicode的格式化目录树，深度控制（1-5级）

性能和安全：

• 无费率限制 -服务器存储克隆的repos，不需要GitHub API调用
• 私有repos支持 -私有存储库的GitHub PAT或SSH密钥
• OAuth 2.1+PKCE -动态客户端注册的完整OAuth流程
• 路径验证 -防止目录遍历，阻止敏感文件
• 浅层克隆 - --depth=1 节省磁盘空间和克隆时间

AI助手功能：

• 使用指南工具 -内置 get_yarmcp_usage_guide() 使用工作流
• Ripgrep搜索 -使用上下文行、性能指标进行快速代码搜索
• 按回购控制 -禁用特定存储库的自动更新（冻结版本）

替代方案

快速开始

用于自托管：参见 example/README.md 获取完整的Docker Compose安装指南。

私有存储库：支持GitHub PAT（环境变量）或SSH密钥（挂载卷）。详情请参阅 example/README.md.

Docker镜像标签和版本控制

YARMCP使用 语义化版本. 对于生产，请固定到特定版本 （例如。， :1.0.0)为了稳定。用于测试 :edge.

图片可在以下网址获得：

• 🐳 Docker Hub: sunnamed434/yarmcp-mcp （推荐，更易于使用）
• 🐙 GitHub容器注册表 （GHCR）： ghcr.io/sunnamed434/yarmcp-mcp （也可用）

看 发布页面 对于可用版本。

📦 Available Docker Tags (click to expand)

稳定发布（建议用于生产）

# Docker Hub (recommended, simpler syntax)
sunnamed434/yarmcp-mcp:1.0.0         # ✅ Specific version (recommended, immutable)
sunnamed434/yarmcp-mcp:1.0           # Latest patch in 1.0.x (auto-updates patches)
sunnamed434/yarmcp-mcp:1             # Latest minor in 1.x.x (auto-updates)
sunnamed434/yarmcp-mcp:latest        # Latest stable (not recommended for production)
sunnamed434/yarmcp-mcp:stable        # Alias for latest stable

# GitHub Container Registry (also available)
ghcr.io/sunnamed434/yarmcp-mcp:1.0.0      # Same images via GHCR

何时使用：

• 生产：使用特定版本(:1.0.0)可预测的行为
• 测试：使用 :latest 或 :1.0 在固定之前测试更新
• 发展：使用 :edge 了解最新更改

预发布版本（测试）

sunnamed434/yarmcp-mcp:0.1.0-alpha.1   # Alpha releases (experimental)
sunnamed434/yarmcp-mcp:0.1.0-beta.1    # Beta releases (feature complete)
sunnamed434/yarmcp-mcp:0.1.0-rc.1      # Release candidates

何时使用：

• 在稳定发布之前测试新功能
• 帮助处理错误报告
• 早期采用者

开发建设（不稳定）

sunnamed434/yarmcp-mcp:edge            # Latest commit from main branch
sunnamed434/yarmcp-mcp:dev             # Same as edge
sunnamed434/yarmcp-mcp:20260203-abc1234  # Specific dev build (date-SHA)

何时使用：

• 促进发展
• 测试未发布的功能
• 报告主分支上的错误

⚠️ 警告： 开发版本可能包含破坏性更改或错误。不建议用于生产。

版本格式

• 稳定版本: MAJOR.MINOR.PATCH （例如。， 1.2.3)
• 发布版本: MAJOR.MINOR.PATCH-TYPE.NUMBER （例如。， 0.1.0-alpha.1)
• 开发版本: YYYYMMDD-SHORTHASH （例如。， 20260203-a1b2c3d)

发展

本地开发

对于贡献者和本地测试，请使用Docker Compose：

cd example
docker compose up

看 example/README.md 有关完整的设置说明。

MCP工具

建筑

┌─────────────┐     ┌─────────────┐
│  MCP Server │◄────│   Updater   │
│  (FastMCP)  │     │  (cron git) │
│  Port 9742  │     │             │
└──────┬──────┘     └──────┬──────┘
       │                   │
       ▼                   ▼
   /opt/yarmcp/repos (shared volume)

• MCP服务器：OAuth 2.1+承载认证，只读仓库访问，提供MCP工具
• 更新器：克隆新存储库，按计划提取更新（默认值：每6小时一次）