Rtc MCP Server

🚀 阿里巴巴雲實時計算 MCP 服務器

本項目是一個用於管理阿里巴巴雲實時計算（Realtime Compute）Apache Flink 資源的 Model Context Protocol (MCP) 服務器實現。它為 AI 模型與 Alibaba Cloud Flink 服務的交互提供了標準化接口，極大地提升了資源管理的效率和便捷性。

🚀 快速開始

先決條件

• JDK 17 或更高版本
• Maven 3.6 或更高版本
• 配備 Alibaba Cloud 訪問權限的阿里雲賬戶（需具備 RTC 即時計算服務權限）
• 阿里巴巴雲訪問密鑰 ID 和秘密

構建與運行

1. 構建項目

mvn clean package

2. 運行服務器

java -jar target/rtc-mcp-server-1.0-SNAPSHOT.jar

✨ 主要特性

• 集群與任務管理：可創建和管理 Flink 集群以及 Flink SQL 任務。
• 應用部署與控制：支持部署和控制 Flink 應用。
• 任務監控：即時監控任務狀態和指標。
• 快照點管理：能夠創建和管理快照點。
• 部署管理：可列出並管理部署。
• 工作區與命名空間管理：對工作區和命名空間進行有效管理。

📦 安裝指南

客戶端配置

要將此服務器作為 MCP 客戶端使用，請在您的 MCP 設置文件中添加以下配置（例如 cline_mcp_settings.json）：

{
  "mcpServers": {
    "rtc-mcp-server": {
      "command": "java",
      "args": [
        "-Dtransport.mode=stdio",
        "-Dspring.main.web-application-type=none",
        "-Dspring.main.banner-mode=off",
        "-Dlogging.file.name=/path/to/rtc-mcp-server/mcpserver.log",
        "-jar",
        "/path/to/rtc-mcp-server/target/rtc-mcp-server-1.0-SNAPSHOT.jar"
      ],
      "env": {
        "ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
        "ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

請將 /path/to/rtc-mcp-server 替換為您實際的服務器路徑，並在環境變量中提供您的阿里雲憑證。

💻 使用示例

可用工具

該服務器提供以下 MCP 工具：

1. 任務管理

• start_job: 啟動已部署的 Flink 任務
• stop_job: 停止正在運行的 Flink 任務
• list_jobs: 列出部署中的所有任務
• delete_job: 刪除非運行狀態的任務
• get_job_diagnosis: 獲取任務診斷信息

2. 部署管理

• create_deployment: 創建新部署
• update_deployment: 更新現有部署
• delete_deployment: 刪除指定部署
• list_deployments: 列出所有部署
• get_deployment_status: 獲取特定部署的狀態

3. 工作區管理

• create_workspace: 創建新工作區
• update_workspace: 更新現有工作區配置
• delete_workspace: 刪除指定工作區
• list_workspaces: 列出所有工作區
• get_workspace_info: 獲取特定工作區的信息

4. 資源管理

• allocate_resources: 申請計算資源
• release_resources: 釋放已分配資源
• modify_resource_limits: 調整資源限制
• view_resource_usage: 查看資源使用情況

📚 詳細文檔

服務器模式

• 標準模式：提供完整的功能，適合生產環境使用。
• 開發模式：增強調試功能，適合開發和測試階段。

日誌記錄

默認情況下，日誌輸出至 mcpserver.log 文件，可通過以下配置調整：

logging.file.name=/path/to/log/mcpserver.log
logging.level=INFO

📄 許可證

本項目遵循 Apache License 2.0 協議，具體內容如下：

除非適用的法律要求或書面同意，否則根據上述許可，軟件及其文檔可在任何情況下免費使用。

🔗 貢獻指南

歡迎社區貢獻！請參考項目文檔瞭解如何參與開發和提交代碼。