MCP Server Devops Bridge

🚀 MCP 服務器 DevOps 橋接器與代理系統

本項目的 MCP（任務控制面板）服務器 DevOps 橋接器，搭配強大的代理系統，可讓人工智能模型創建、管理和協調長期運行的代理，為人工智能與實際任務的結合提供了高效的解決方案。

🚀 快速開始

請查看 examples 文件夾中的代碼示例，瞭解如何使用此庫。您還可以參考 官方文檔 瞭解更多詳細信息。

環境變量配置

以下是項目的環境變量配置示例：

# MCP Server 配置
export MCP_SERVER_PORT=8080
export MCP_SERVER_HOST=localhost

# 數據庫連接配置
export DB_HOST=localhost
export DB_PORT=3306
export DB_NAME=mcp_db
export DB_USER=root
export DB_PASSWORD=secret

# 日誌配置
export LOG_LEVEL=info
export LOG_FILE=log.txt

快速啟動

您可以通過以下步驟快速啟動 MCP 服務器：

1. 克隆倉庫：

   git clone https://github.com/yourusername/mcp-server.git
   cd mcp-server
   

2. 安裝依賴項：

   go mod tidy
   

3. 啟動服務器：

   go run main.go
   

文檔

• MCP 服務器 API 文檔：API 文檔鏈接
• 代理系統文檔：代理文檔鏈接

貢獻指南

如果您希望為項目做出貢獻，請參考 貢獻指南。

✨ 主要特性

該系統使人工智能模型能夠：

1. 創建具有自定義系統提示和任務的新長期運行代理
2. 向現有代理發送命令
3. 通過消息系統實現代理之間的通信
4. 監控和管理代理的生命週期

📦 安裝指南

環境變量配置

以下是項目的環境變量配置示例：

# MCP Server 配置
export MCP_SERVER_PORT=8080
export MCP_SERVER_HOST=localhost

# 數據庫連接配置
export DB_HOST=localhost
export DB_PORT=3306
export DB_NAME=mcp_db
export DB_USER=root
export DB_PASSWORD=secret

# 日誌配置
export LOG_LEVEL=info
export LOG_FILE=log.txt

快速啟動

您可以通過以下步驟快速啟動 MCP 服務器：

1. 克隆倉庫：

   git clone https://github.com/yourusername/mcp-server.git
   cd mcp-server
   

2. 安裝依賴項：

   go mod tidy
   

3. 啟動服務器：

   go run main.go
   

💻 使用示例

基礎用法

// 獲取所有代理相關工具
tools := ai.GetAllToolsAsOpenAI()

// 創建 OpenAI 客戶端
client := openai.NewClient()

// 使用 OpenAI 協調代理
messages := []openai.ChatCompletionMessageParamUnion{
    openai.SystemMessage(`你是代理的協調員。`),
    openai.UserMessage("創建兩個代理並讓他們協作工作。"),
}

// 調用 OpenAI 並使用我們的工具
params := openai.ChatCompletionNewParams{
    Model:    openai.F(openai.ChatModelGPT4o),
    Messages: openai.F(messages),
    Tools:    openai.F(tools),
}

// 處理響應並處理工具調用
// ...

高級用法

示例代理工作流程

1. 創建代理：創建專門用於不同任務的代理

   工具: agent
   參數: {"id": "researcher", "system_prompt": "你是一個研究型代理...", "task": "查找關於氣候變化的信息"}
   

2. 訂閱主題：讓代理收聽相關消息

   工具: subscribe_agent
   參數: {"agent_id": "writer", "topic": "research_results"}
   

3. 發送消息：在代理之間共享信息

   工具: send_agent_message
   參數: {"topic": "research_results", "content": "以下是我在研究中發現的信息..."}
   

4. 發送命令：向代理發出直接指令

   工具: send_command
   參數: {"agent_id": "writer", "command": "用三段總結你的研究結果。"}
   

📚 詳細文檔

關鍵組件

代理管理

該系統提供了以下功能：

• 創建代理：創建具有自定義系統提示和任務的新代理
• 列出代理：查看所有正在運行的代理及其狀態
• 發送命令：向特定代理發送指令或查詢
• 訂閱主題：使代理收聽特定頻道的消息
• 終止代理：在不再需要時終止代理

代理間通信

代理之間可以通過以下方式進行通信：

• 消息總線：一箇中心化的消息系統，負責將消息路由到已訂閱的代理
• 主題：代理可以發佈到和訂閱的主題頻道
• 直接命令：向特定代理發送指令

系統工具

該系統提供了以下工具：

• 命令執行：帶有適當安全控制的系統命令運行
• 消息傳遞：在代理之間發送和接收消息
• 代理管理：創建、監控和終止代理

🔧 技術細節

該系統實現了以下安全機制：

• 代理僅具有為其明確授予的命令和路徑訪問權限
• 命令執行是容器化的，以提供隔離
• 所有通信都通過受控頻道進行管理

📄 許可證

該軟件受 MIT License 保護。