Spring MCP Bridge

Spring MCP Bridge

Spring MCP Bridge 是一款工具，可自动将 Spring Boot 应用中的 REST 端点转换为 MCP（Message Conversation Protocol）服务，让 Claude、Cursor 等 AI 助手及其他兼容 MCP 的工具能够直接与你的 API 交互。

*目前不包含身份验证。如果你的 Spring Boot API 需要身份验证，则需要修改处理程序代码，以添加适当的标头或令牌。

📖 概述

将现有 API 集成到 AI 助手通常需要手动编写代码或进行复杂配置。Spring MCP Bridge 会自动扫描你的 Spring Boot 项目，并生成可直接使用的 MCP 服务，从而消除这些复杂步骤。

✨ 功能

• 自动扫描：发现所有 REST 端点（@RestController、@GetMapping 等）
• 零配置：无需修改现有 Spring Boot 代码
• 保留模型：将请求和响应模型作为 MCP 工具保留
• 提取 Javadoc：使用现有文档完善 MCP 工具描述
• 完整文档：生成 README 和清晰的使用说明

🚀 安装

# Clone the repository
git clone https://github.com/brunosantos/spring-mcp-bridge.git

# Enter the directory
cd spring-mcp-bridge

🛠️ 使用方法

1. 扫描 Spring Boot 项目：

python spring_boot_mcp_converter.py --project /path/to/spring-project --output ./mcp_server --name MyAPI

2. 运行生成的 MCP 服务：

cd mcp_server
pip install -r requirements.txt
python main.py

3. 通过 MCP 客户端连接：
   • 配置 MCP 客户端（Claude、Cursor 等），使用 http://localhost:8000
   • MCP 架构将在 http://localhost:8000/.well-known/mcp-schema.json 提供

📋 参数

参数	描述	默认值
--project	Spring Boot 项目的路径	（必需）
--output	输出目录	./mcp_server
--name	应用名称	SpringAPI
--debug	启用调试日志	False

💻 示例

python spring_mcp_bridge.py --project ~/projects/my-spring-api --output ./mcp_server --name MyAPI

该工具将：

1. 扫描 Spring Boot 项目中的 REST 控制器
2. 识别模型类型、参数和返回类型
3. 生成功能完整的 Python/FastAPI MCP 服务
4. 创建描述所有端点的兼容 MCP 架构

🔄 工作原理

1. 扫描：分析 Java 源代码，提取 REST 端点的元数据
2. 转换：将 Java 类型转换为 JSON Schema 类型，以兼容 MCP
3. 生成：创建 FastAPI 应用，将 MCP 调用映射为 Spring REST 调用
4. 转发：将 MCP 客户端发出的请求路由到 Spring Boot 应用

🔍 支持的 Spring Boot 功能

• REST 控制器（@RestController、@Controller）
• HTTP 方法（@GetMapping、@PostMapping、@PutMapping、@DeleteMapping、@PatchMapping）
• 请求参数（@RequestParam）
• 路径变量（@PathVariable）
• 请求体（@RequestBody）
• Java 模型和 DTO

⚙️ 配置

可以通过编辑 main.py 文件配置生成的 MCP 服务：

# The Spring Boot base URL - modify this to match your target API
SPRING_BASE_URL = "http://localhost:8080"

🧪 测试

测试 MCP 服务：

1. 确保 Spring Boot 应用正在运行
2. 启动 MCP 服务
3. 访问 http://localhost:8000/docs 查看 FastAPI 文档
4. 查看 http://localhost:8000/.well-known/mcp-schema.json 中的 MCP 架构
5. 使用 Claude 等 MCP 客户端连接

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将更改推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

📄 许可证

本项目基于 MIT License 授权，详情请参阅 LICENSE 文件。

👨‍💻 作者

Bruno Santos

🙏 致谢

• 灵感来源于 FastAPI-MCP 以及不断发展的 MCP 兼容工具生态
• 感谢 Spring Boot 和 FastAPI 社区