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. 监控和管理代理的生命周期

🔧 技术细节

关键组件

代理管理

该系统提供了以下功能：

• 创建代理：创建具有自定义系统提示和任务的新代理
• 列出代理：查看所有正在运行的代理及其状态
• 发送命令：向特定代理发送指令或查询
• 订阅主题：使代理收听特定频道的消息
• 终止代理：在不再需要时终止代理

代理间通信

代理之间可以通过以下方式进行通信：

• 消息总线：一个中心化的消息系统，负责将消息路由到已订阅的代理
• 主题：代理可以发布到和订阅的主题频道
• 直接命令：向特定代理发送指令

系统工具

该系统提供了以下工具：

• 命令执行：带有适当安全控制的系统命令运行
• 消息传递：在代理之间发送和接收消息
• 代理管理：创建、监控和终止代理

安全措施

该系统实现了以下安全机制：

• 代理仅具有为其明确授予的命令和路径访问权限
• 命令执行是容器化的，以提供隔离
• 所有通信都通过受控频道进行管理

💻 使用示例

基础用法

// 获取所有代理相关工具
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 保护。