Spring MCP Bridge
2025.04.16
1
PythonAPI 集成自动化工具开发效率
Spring MCP Bridge 是一个工具，能够自动将 Spring Boot 应用程序中的 REST 端点转换为 MCP（Message Conversation Protocol）服务器，使得像 Claude、Cursor 等 MCP 兼容工具能够直接与你的 API 进行交互。该工具无需修改现有 Spring Boot 代码，自动扫描项目并生成可用的 MCP 服务器。
View on GitHub
Overview
基本能力
产品定位
Spring MCP Bridge 是一个开发效率工具，旨在简化 Spring Boot 应用程序与 AI 助手（如 Claude、Cursor 等）的集成过程。
核心功能
- 自动扫描：发现所有 REST 端点（@RestController、@GetMapping 等）。
- 零配置：无需修改现有 Spring Boot 代码。
- 模型保留：将请求和响应模型保留为 MCP 工具。
- Javadoc 提取：利用现有文档增强 MCP 工具描述。
- 完整文档：生成 README 和清晰的使用说明。
适用场景
- 需要将 Spring Boot API 快速集成到 MCP 兼容工具中的开发场景。
- 需要自动化生成 API 文档的场景。
- 需要简化 AI 助手与后端服务交互的开发流程。
工具列表
- spring_boot_mcp_converter.py：扫描 Spring Boot 项目并生成 MCP 服务器的 Python 脚本。
- main.py：生成的 FastAPI 应用程序，用于路由 MCP 调用到 Spring Boot 应用程序。
常见问题解答
- 认证问题：当前版本不包含认证功能，如需认证需手动修改处理代码。
- 调试问题：可通过
--debug参数启用调试日志。
使用教程
使用依赖
- Python 3.8+
- Spring Boot 3.x
安装教程
# 克隆仓库
git clone https://github.com/brunosantos/spring-mcp-bridge.git
# 进入目录
cd spring-mcp-bridge
使用步骤
- 扫描 Spring Boot 项目：
python spring_boot_mcp_converter.py --project /path/to/spring-project --output ./mcp_server --name MyAPI
- 运行生成的 MCP 服务器：
cd mcp_server
pip install -r requirements.txt
python main.py
- 通过 MCP 客户端连接：
- 配置 MCP 客户端使用
http://localhost:8000 - MCP schema 位于
http://localhost:8000/.well-known/mcp-schema.json
调试方式
- 确保 Spring Boot 应用程序正在运行。
- 启动 MCP 服务器。
- 访问
http://localhost:8000/docs查看 FastAPI 文档。 - 检查 MCP schema 位于
http://localhost:8000/.well-known/mcp-schema.json。 - 使用 MCP 客户端（如 Claude）进行连接测试。