DCR MCP Server

DCR MCP Server

一个 Model Context Protocol（MCP）服务，提供开发和研究工具：Git 分析、文献搜索、Markdown/PDF 转换和邮件草拟。

目录

• 快速开始
• 安装选项
• 配置
• 工具参考
  • 🔍 Git 摘要
  • 🔬 文献搜索
  • 📝 Markdown 转换器
  • 📄 PDF 生成器
  • ✉️ 邮件提示词
• 开发

快速开始

1. 安装

   go install github.com/dictybase/dcr-mcp/cmd/server@latest
   

2. 配置 - 添加到你的 MCP 配置中：

   {
       "mcpServers": {
           "dcr-mcp": {
               "command": "server",
               "env": {
                   "OPENAI_API_KEY": "your-api-key-here"
               }
           }
       }
   }
   

3. 使用 - 此服务提供以下工具：

   • Git 摘要 - 使用 AI 分析提交消息
   • 文献 - 根据 PMID/DOI 获取研究论文
   • Markdown - 转换为支持 GFM 的 HTML
   • PDF - 从 Markdown 生成 PDF
   • 邮件 - 草拟轻松随意的邮件

安装选项

方法	命令	二进制文件名称	适用场景
Go 安装	go install github.com/dictybase/dcr-mcp/cmd/server@latest	server	快速设置
从源代码安装	git clone && make build	dcr-mcp-server	开发
手动构建	go build -o dcr-mcp-server ./cmd/server	dcr-mcp-server	自定义构建

要求： Go 1.23.8+，OpenAI API 密钥（用于 Git 摘要）

配置

MCP 设置

根据安装方式使用正确的命令：

{
    "mcpServers": {
        "dcr-mcp": {
            "command": "server",  // for go install
            // or "command": "dcr-mcp-server",  // for source build
            // or "command": "/full/path/to/binary",  // for custom path
            "env": {
                "OPENAI_API_KEY": "your-api-key-here"
            }
        }
    }
}

此服务会随 MCP 客户端自动启动，并将结构化日志输出到 stderr，便于调试。

工具参考

🔍 Git 摘要

分析 Git 提交，并按类型生成 AI 摘要。

参数：

• repo_url（必填）- Git 仓库 URL
• branch（必填）- 要分析的分支
• start_date（必填）- 分析开始日期
• end_date（可选）- 结束日期（默认为当前时间）
• author（必填）- 按作者姓名筛选
• api_key（必填）- OpenAI API 密钥

输出： 按类别整理的 Markdown 摘要，包含项目符号列表（功能、错误修复、文档等）

🔬 文献搜索

通过 dictyBase API 使用 PubMed ID 或 DOI 获取科学论文。

参数：

• id（必填）- PMID（例如，“12345678”）或 DOI（例如，“10.1038/nature12373”）
• id_type（必填）- “pmid”或“doi”
• provider（可选）- “pubmed”（默认）或“europepmc”

输出： 格式化的文章元数据，包含标题、作者、摘要和引用数据

📝 Markdown 转换器

将 Markdown 转换为支持 GitHub Flavored Markdown 的 HTML。

参数：

• content（必填）- 要转换的 Markdown 内容

功能： GFM、语法高亮、表情符号、表格、YAML 元数据

📄 PDF 生成器

将 Markdown 转换为格式专业的 PDF。

参数：

• content（必填）- Markdown 内容
• filename（可选）- 输出文件名（默认为“output.pdf”）

输出： 使用 IBM Plex 字体的 PDF 文件和确认消息

✉️ 邮件提示词

生成可自定义语气的轻松随意邮件草稿。

参数：

• from（必填）- 发件人姓名或邮箱
• to（必填）- 收件人姓名或邮箱

输出： 完整的邮件草稿，包含主题行，语气友好且专业

开发

构建命令

命令	用途
make build	将二进制文件构建到 bin/dcr-mcp-server
make test	运行所有测试
make test-verbose	运行测试并显示详细输出
make fmt	使用 gofumpt 格式化代码
make clean	移除构建产物

项目结构

dcr-mcp/
├── cmd/server/              # Main entry point
├── pkg/
│   ├── tools/              # Core tool implementations
│   │   ├── gitsummary/     # Git analysis + OpenAI
│   │   ├── literaturetool/ # PubMed/DOI fetching  
│   │   ├── markdowntool/   # Markdown → HTML
│   │   └── pdftool/        # Markdown → PDF
│   ├── prompts/            # Email prompt logic
│   └── markdown/           # Shared markdown utilities
└── bin/                    # Built binaries

参与贡献

1. Fork 并创建功能分支
2. 遵循 CLAUDE.md 中的规范
3. 为新功能添加测试
4. 运行：make fmt && make test && golangci-lint run
5. 提交拉取请求

调试

服务会将带前缀的消息记录到 stderr：

• [git-summary]、[literature]、[markdown]、[pdf-tool]、[email-prompt]

在 MCP 客户端中启用 stderr 输出以进行调试。