Spring MCP Bridge

Spring MCP Bridge 是一个工具，可以自动将 Spring Boot 应用程序中的 REST 端点转换为 MCP（消息对话协议）服务器，使像 Claude、Cursor 和其他兼容 MCP 的工具可以直接与您的 API 进行交互。

*目前不包括身份验证。如果您的 Spring Boot API 需要身份验证，您需要修改处理器代码以包含适当的头或令牌。

📖 概述

将现有 API 与 AI 助手集成通常需要手动编码或复杂的配置。Spring MCP Bridge 通过自动扫描您的 Spring Boot 项目并生成一个可立即使用的 MCP 服务器来消除这种复杂性。

✨ 特性

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

🚀 安装

# 克隆仓库
git clone https://github.com/brunosantos/spring-mcp-bridge.git

# 进入目录
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 服务器：

# Spring Boot 基础 URL - 修改此 URL 以匹配目标 API
SPRING_BASE_URL = "http://localhost:8080"

🧪 测试

要测试 MCP 服务器：

1. 确保您的 Spring Boot 应用程序正在运行
2. 启动 MCP 服务器
3. 访问 http://localhost:8000/docs 查看 FastAPI 文档
4. 在 http://localhost:8_000/.well-known/mcp-schema.json 检查 MCP 架构
5. 使用像 Claude 这样的 MCP 客户端进行连接

🤝 贡献

欢迎贡献！请随时提交拉取请求。

1. 分叉仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些很棒的功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开拉取请求

📄 许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

👨‍💻 作者

Bruno Santos

🙏 致谢

• 受 FastAPI-MCP 和不断增长的 MCP 兼容工具生态系统启发
• 感谢 Spring Boot 和 FastAPI 社区