MCP Service Broker

🚀 MCP服務經紀商

MCP服務經紀商是一個基於Spring Cloud Open Service Broker的平臺，主要用於註冊和綁定模型上下文協議（MCP）服務器。該平臺支持Cloud Foundry、本地和Kubernetes等多種環境，為用戶提供了便捷的MCP服務器管理方案。

✨ 主要特性

• 通過Cloud Foundry服務經紀商API或REST API註冊MCP服務器。
• 將MCP服務器綁定到應用程序，在綁定時提供憑證。
• 提供REST API進行圖形化管理。
• 基於React的UI用於目錄瀏覽和註冊（請參見frontend/文件夾）。
• 配置文件基於持久化，內存適用於本地和Kubernetes環境，Postgres適用於Cloud Foundry環境。
• 啟用actuator端點以提供健康狀態和信息監控。

🚀 快速開始

本地開發

./mvnw spring-boot:run -Dspring-boot.run.profiles=local

Cloud Foundry環境

綁定一個Postgres服務，使用cloudfoundry配置文件進行部署。數據源自動從VCAP_SERVICES配置。

REST API使用說明

• GET /api/mcp-servers — 列出所有MCP服務器。
• POST /api/mcp-servers — 註冊新的MCP服務器（需要JSON格式的請求體）。
• DELETE /api/mcp-servers/{instanceId} — 刪除指定ID的MCP服務器。

用戶界面

在frontend/文件夾啟動基於React的UI（請參見前端README文檔）。

📦 安裝指南

本地環境

使用以下命令啟動應用：

./mvnw spring-boot:run -Dspring-boot.run.profiles=local

Cloud Foundry環境

1. 綁定一個Postgres服務。
2. 使用cloudfoundry配置文件進行部署，數據源會自動從VCAP_SERVICES配置。

💻 使用示例

基礎用法

列出所有MCP服務器

curl -X GET http://localhost:8081/api/mcp-servers

註冊新的MCP服務器

curl -X POST http://localhost:8081/api/mcp-servers -H "Content-Type: application/json" -d '{
    "name": "new-mcp-server",
    "url": "http://example.com/mcp"
}'

高級用法

刪除指定ID的MCP服務器

curl -X DELETE http://localhost:8081/api/mcp-servers/123

📚 詳細文檔

配置文件說明

Spring Boot Actuator端點

默認啟用以下actuator端點：

• /actuator/health — 返回應用程序的健康狀態（適用於Cloud Foundry、Kubernetes及監控工具）。
• /actuator/info — 返回應用程序的信息（可在應用屬性文件中自定義）。

訪問這些端點的方式：

• 本地：http://localhost:8081/actuator/health 和 http://localhost:8081/actuator/info
• Cloud Foundry：https://.cfapps.io/actuator/health 和 /actuator/info
• Kubernetes：http://:8080/actuator/health 和 /actuator/info

要暴露更多actuator端點，請在屬性文件中修改management.endpoints.web.exposure.include配置。

📄 許可證

本項目採用MIT許可證。