DCR MCP 服务器

使用 mcp-go 实现的一个简单的 MCP（模型控制协议）服务器。

功能特点

• 基础 MCP 服务器实现
• Git 汇总工具，用于分析提交信息

快速入门

先决条件

• Go 1.23 或更高版本

运行服务器

go run cmd/server/main.go

默认情况下，服务器在端口 8080 上运行。您可以通过设置 DCR_MCP_PORT 环境变量来更改端口。

工具

Git 汇总工具

此 MCP 工具使用 OpenAI 分析任何仓库的提交信息，并生成易于理解的人类可读汇总，按类别组织。

功能特点

• 通过 URL 克隆任意 Git 仓库
• 按日期范围筛选提交
• 按作者过滤
• 使用 OpenAI 生成简洁摘要
• 输出为带分类项目的 Markdown 格式

使用方法

工具接受以下参数：

{
  "repo_url": "https://github.com/username/repo",
  "branch": "main",
  "start_date": "2023-01-01",
  "end_date": "2023-12-31",
  "author": "author-name"
}

参数说明

• repo_url（必填）：要分析的 Git 仓库 URL
• branch（必填）：要分析的分支
• start_date（必填）：开始分析提交的日期（支持任何标准格式）
• end_date（可选）：结束分析提交的日期（默认为当前日期）
• author（必填）：按作者名称筛选提交（不区分大小写的包含匹配）
• api_key（必填）：您的 OpenAI API 密钥（默认使用 OPENAI_API_KEY 环境变量）

示例响应

"# 工作汇总\n\n功能增强\n- 增加了按作者过滤提交的支持。用户现在可以指定一个可选的 author 参数，以关注特定团队成员的贡献。\n\n问题修复\n- 修复了日期解析中的问题，这些问题曾导致提交范围不正确。系统现在能够正确处理各种日期格式和时区考虑因素。\n\n文档改进\n- 添加了全面的 README 文件，包含使用示例和参数描述。新用户将发现如何有效使用该工具更加容易理解。"

测试

运行测试：

go test ./...

或者使用 gotestum：

gotestum --format-hide-empty-pkg --format testdox --format-icons hivis