Spring MCP Bridge

🚀 Spring MCP 橋接工具

Spring MCP 橋接工具是一款強大的工具，它能自動把 Spring Boot 應用裡的 REST 端點轉換為 MCP（消息對話協議）服務器。這使得 Claude、Cursor 等 MCP 兼容工具可以直接與您的 API 進行交互，極大地提升了 API 與 AI 助手集成的效率。

⚠️ 重要提示

目前版本尚未包含認證功能。若需使用需要認證的 Spring Boot API，請在處理代碼中添加相應的頭信息或令牌。

🚀 快速開始

將現有 API 集成到 AI 助手通常需要手動編碼或複雜配置。Spring MCP 橋接工具通過自動掃描您的 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 可用

高級用法

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

📚 詳細文檔

📋 參數

配置說明

項目配置

在 config.py 文件中，可以自定義以下設置：

# 設置日誌級別
LOG_LEVEL = "DEBUG"

# 設置最大線程數
MAX_THREADS = 10

環境變量

可以通過環境變量進一步配置橋接工具：

export MCP_BRIDGE_ENV=development
export MCP_BRIDGE_PORT=8000

使用示例

創建項目

# 初始化新項目
mkdir my_mcp_project
cd my_mcp_project
python -m spring_mcp_bridge init

運行服務器

# 安裝依賴
pip install -r requirements.txt

# 啟動服務器
python main.py

🔧 技術細節

• 自動掃描：支持所有標準的 Spring Boot 註解，如 @RestController、@GetMapping、@PostMapping 等。
• 模型綁定：自動處理請求參數和響應模型，無需額外配置。
• 異常處理：內置異常處理機制，能夠將常見錯誤轉換為 MCP 標準錯誤格式。

📄 許可證

本項目採用 MIT 許可證。

🙏 致謝

• 受 FastAPI - MCP 和 MCP 工具生態的啟發
• 感謝 Spring Boot 和 FastAPI 社區

開發者

Bruno Santos