Spring MCP Bridge

Spring MCP Bridge 是一个工具，可以自动将 Spring Boot 应用程序中的 REST 端点转换为 MCP（消息会话协议）服务器，从而允许像 Claude、Cursor 和其他 MCP 兼容工具等 AI 助手直接与您的 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 schema 将在 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 schema，描述所有端点

🔄 工作原理

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 - 修改此项以匹配您的目标 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 schema
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 文件。

👨‍💻 作者

Bruno Santos

🙏 鸣谢

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