Spring Boot MCP Copilot

Spring Boot MCP 服务器 — Copilot 指令与提示

这台服务器提供了工具/资源以供 渲染Markdown提示 并且到 写 .github/copilot-instructions.md 上传到GitHub仓库。

先决条件

• Java 21
• Maven 3.9+

构建并运行（stdio传输）

mvn -q -e -DskipTests package
java -jar target/spring-boot-mcp-copilot-1.0.0.jar

MCP服务器运行在 STDIO 翻译为中文是“标准输入输出（Standard Input and Output）”。 （没有监听的TCP端口）。您的MCP客户端（例如，JetBrains AI Assistant或GitHub Copilot Chat）应作为命令启动此进程。

替代方案（SSE/WebSocket）

开关 spring.ai.mcp.server.transport 在里面 src/main/resources/application.yml 并正常运行（例如。， mvn spring-boot:run）。

暴露的MCP功能

工具

• listPrompts() → 列出以下可用的提示文件 copilot/prompts/。
• renderPrompt(name, args?) → 根据名称和模板参数渲染一个提示；返回渲染后的文本+前置内容。
• writeCopilotInstructionsFromFile(owner, repo, branch, token, file, args?)\

渲染（结果/图像） copilot/instructions/{file}.md 与；和；带着 args 并写入到 .github/copilot-instructions.md 使用GitHub内容API。

资源

• instructionMd(file) → 退货 {meta, body} of copilot/instructions/{file}.md 用于聊天上下文。

你将编辑的文件

• copilot/instructions/org-default.md — 全组织基线（如需，请复制到组织设置中）
• copilot/instructions/spring-boot-repo.md — 渲染到仓库
• copilot/prompts/*.md — 使用YAML前置信息的可重用提示

模板令牌

使用 {{name}} 或者 {{name|DEFAULT}} 在MD文件内部。参数通过工具调用来传递。

在 IntelliJ 中连接（JetBrains AI 助手）

1. IntelliJ IDEA 2025.1及以上版本 和；与；带着 人工智能助手 以及MCP支持。
2. 首选 设置 | 工具 | AI 助手 | 模型上下文协议 (MCP) 并且 添加 一个服务器：

- 交通命令（STDIO） - 命令： java - 论点；争论点: -jar， /target/spring-boot-mcp-copilot-1.0.0.jar - 工作目录项目文件夹

1. 连接后，打开AI聊天并运行：

- /tool listPrompts - /tool renderPrompt {"name":"spring-boot-coding","args":{"feature":"Order API","package":"com.example.orders"}} - /tool writeCopilotInstructionsFromFile {"owner":"","repo":"","branch":"main","token":" ","file":"spring-boot-repo","args":{"serviceName":"orders-service"}}

注： - 对于仓库说明，GitHub 会查找 .github/copilot-instructions.md。 - 确保您的PAT（个人剂量计/便携式分析仪等，具体根据上下文确定）已 repo 范围。 - 如果你更倾向于审查而非直接提交代码，请使用分支保护+拉取请求（PRs）。

安全

• 代币在调用时传递；它是 不是 由服务器存储。考虑使用您的MCP客户端的秘密存储功能。
• 在您的MCP主机上记录日志；服务器默认仅打印最少的日志。

许可证

Apache-2.0（许可证）