Java Spring Boot Spring AI MCP Protocol

GitHub MCP Server 是一款基于 Spring Boot 与 Spring AI 架构标准构建的 Model Context Protocol (MCP) 服务端应用。 本项目专为大模型（LLMs）和 AI Agent 设计，赋予它们直接操作系统与真实的 GitHub 仓库的能力。通过深度集成的 GitHub GraphQL API，AI 助手可以在对话中全自动地完成技术内容的排版、提交与发布（如自动发布 Discussions 帖子、管理仓库文件等），为你打造极客级别的自动化工作流。

✨ 核心特性

• 🤖 原生拥抱 MCP 标准：通过 Spring AI 原生注解暴露能力（ToolRegistrationConfig），无缝对接支持 MCP 的各大主流 AI 编程助手（如 Cline、Continue、Cursor 以及你自定义的 Agent 平台）。
• 📡 强大的 GraphQL 引擎：不同于基础的 REST API，本项目在 GitHubPublishTools 中深度融合了 GraphQL 机制，能够精准调用高级特性（如指定 Category ID 将技术文章直接发布到指定的 Discussions 模块）。
• 🛠️ 自动化内容管理：只需一句话，大模型即可将生成的 Markdown 文本、分析报告或代码片段一键沉淀到你的 GitHub 知识库中。
• 🐳 开箱即用的工程化部署：极其完善的运维支撑。自带 build.sh 与 deploy-github-server.sh 脚本，结合 docker-compose-service.yml 实现真正的一键云端部署。

📁 项目核心结构

项目采用了非常清晰的工程化结构，关键目录说明如下：

mcp-server-github-app/
├── src/main/java/cn/bugstack/mcp/server/github/
│   ├── GitHubPublishTools.java     # 核心工具类：封装 GraphQL 请求逻辑与 AI Tool 方法
│   ├── GitHubToolProperties.java   # 统一配置映射：管理 Token 与 Repository 参数
│   ├── ToolRegistrationConfig.java # Bean 装配：Spring AI MCP 工具的安全注册
│   └── McpServerApplication.java   # Spring Boot 启动入口
├── src/main/resources/
│   └── application.yml             # 核心配置文件
├── build.sh                        # Docker 镜像本地构建脚本
├── deploy-github-server.sh         # Docker 容器一键启动/更新脚本
├── docker-compose-service.yml      # 容器化服务编排文件
└── SERVER_DEPLOY.md                # 专属的服务器详细部署指南

🚀 快速开始

1. 准备 GitHub 凭证

在启动服务前，你需要准备一个具备对应权限的 Personal Access Token (PAT)。确保该 Token 拥有读取和写入仓库内容（如 Discussions, Issues）的权限。

在项目的 application.yml 中配置以下核心参数（或通过环境变量注入）：

github.token: 你的 GitHub PAT

github.repository: 目标仓库的基础信息

github.discussion-category-id: 目标 Discussion 发帖分类的 ID

2. 本地开发与调试

本项目基于标准 Maven 构建：

Bash

1. 克隆并进入项目目录

cd mcp-server-github-app

2. 编译项目

mvn clean install -DskipTests

3. 启动服务

mvn spring-boot:run 服务启动后，它将遵循 MCP 协议标准（stdio/SSE）暴露工具列表，时刻准备接收来自 AI 客户端的调用。

3. Docker 容器化一键部署

推荐使用 Docker 进行环境隔离和生产部署，项目已经为你写好了所有的自动化脚本：

Bash

1. 赋予部署脚本执行权限

chmod +x build.sh deploy-github-server.sh

2. 构建最新镜像

./build.sh

3. 启动或更新服务

./deploy-github-server.sh (详细的进阶服务器配置，请参阅 SERVER_DEPLOY.md)

🔌 如何接入你的 AI 助手 (示例) 一旦服务运行，你可以在各类 AI 客户端的 MCP 配置（如 mcp.json）中直接挂载本服务。

以 stdio 方式本地挂载为例：

{
  "mcpServers": {
    "github-publisher": {
      "command": "java",
      "args": ["-jar", "/你的绝对路径/mcp-server-github-app/target/mcp-server-github-app.jar"]
    }
  }
}

🤝 参与贡献 欢迎大家参与完善这个 MCP Server！你可以通过提交 Issue 探讨新的工具想法（例如：让 Agent 自动帮你 Review PR），也非常欢迎直接提交 Pull Request！

📄 许可证 本项目采用 MIT License 协议开源。