MCP Repo Monitor

通过Claude Code实现GitHub自动化的MCP服务器。8个工具，零上下文切换。

工具 • 设置 • 配置 • 克劳德集成 • 建筑

______________________________________________________________________

特性

技术栈

语言和框架

基础设施和工具

我为什么建造这个

我管理多个仓库，厌倦了：

• 手动检查PR状态
• 忘记哪些树枝在飘动
• 上下文切换到GitHub以获取CI状态

现在我问克劳德：“有任何失败的CI运行吗？”并立即得到答案。

______________________________________________________________________

工具

工具示例

列出存储库状态

"Show me the status of all my repositories"
"Which repos have failing CI?"
"List repos with open PRs"

检查拉取请求

"Show me all open PRs"
"List PRs in my-org/api"
"Any PRs waiting for review?"

CI/CD监控

"Any failing CI runs on main?"
"Check CI status for my-org/api"
"Show me recent workflow runs for feature-branch"

漂移检测

"Check drift between main and develop"
"Are any of my repos out of sync?"
"Show drift for my-org/api"

同步和公关创建

"Create a sync PR for my-org/api"
"Preview sync PR for my-repo (dry run)"
"Create a PR from feature/auth to develop"

回滚操作

"Rerun the last failed workflow on my-org/api"
"What rollback options are available?"
"Trigger rollback workflow for production"

______________________________________________________________________

设置

1.获取GitHub Token

创建 个人访问令牌 使用这些范围：

• repo -完全访问存储库
• workflow -执行工作流
• read:user -读取用户资料

2.创建 .env

cp .env.example .env
# Add your token
GITHUB_TOKEN=ghp_xxxx

或者，创建 ~/.mcp-repo-monitor/.env 用于用户范围的配置。

______________________________________________________________________

配置

回答。

创建 ~/.mcp-repo-monitor/repos.json 要自定义每个存储库的分支名称，请执行以下操作：

{
  "default": {
    "prod_branch": "main",
    "dev_branch": "develop"
  },
  "repositories": {
    "my-org/api": {
      "prod_branch": "production",
      "dev_branch": "main"
    }
  }
}

命令行标志

./mcp-repo-monitor --help

  --mode string      Server mode: stdio or sse (default "stdio")
  --addr string      Address for SSE server (default ":8080")
  --log-level string Log level: debug, info, warn, error (default "info")

______________________________________________________________________

用法

本土的

make build      # Build binary
make run        # Run stdio mode
make run-sse    # Run SSE server on :8080
make inspect    # MCP Inspector UI
make test       # Run all tests

码头工人

make docker-build
make docker-run

______________________________________________________________________

Claude代码集成

选项1：本机二进制

添加到您的克劳德代码设置(~/.claude/settings.json):

{
  "mcpServers": {
    "repo-monitor": {
      "command": "/path/to/mcp-repo-monitor/bin/mcp-repo-monitor"
    }
  }
}

选项2:Docker

{
  "mcpServers": {
    "repo-monitor": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file", "/path/to/.env", "mcp-repo-monitor"]
    }
  }
}

选项3：使用调试日志记录

{
  "mcpServers": {
    "repo-monitor": {
      "command": "/path/to/mcp-repo-monitor/bin/mcp-repo-monitor",
      "args": ["--log-level=debug"]
    }
  }
}

______________________________________________________________________

建筑

Go的简洁架构：

internal/
├── domain/           # Entities & business logic
│   ├── entity/       # Repository, PR, Commit, Workflow, Branch
│   └── service/      # DriftDetector, RollbackService
├── application/      # Use cases
│   ├── port/         # GitHubClient interface
│   └── usecase/      # 8 use cases
└── infrastructure/   # External services
    ├── cache/        # In-memory TTL caching
    ├── github/       # go-github client with rate limiting & retry
    ├── logging/      # Structured JSON logging (slog)
    └── mcp/          # MCP server, handlers, presenters

______________________________________________________________________

故障排除

“GITHUB_TOKEN环境变量是必需的”

确保您的令牌已设置：

cat .env
# Or user config
cat ~/.mcp-repo-monitor/.env

“repos.JSON中的JSON无效”

验证JSON语法：

cat ~/.mcp-repo-monitor/repos.json | jq .

速率限制错误

当速率限制较低时，客户端会自动等待。对于频繁使用：

1. 使用具有更高限制的令牌（GitHub Pro/Enterprise）
2. 缓存减少了对重复查询的API调用
3. 检查日志： --log-level=debug

MCP连接问题

1. 验证二进制文件是否独立运行：

   echo '{"jsonrpc":"2.0","method":"initialize","id":1}' | ./bin/mcp-repo-monitor

1. 检查克劳德代码日志是否有错误
2. 确保设置中的路径是绝对的

______________________________________________________________________

验尸

______________________________________________________________________

贡献

1. 克隆该仓库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'feat: add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________