Skynet-MCP (本项目正在开发中)

一个使用模型上下文协议 (MCP) 的 AI 代理分层网络。此网络中的 AI 代理可以生成新的代理来执行工作，每个代理还包括启动代理拥有的所有工具。 代理网络能够处理复杂的任务，范围从研究、报告到编码。

通过利用不断增长的 MCP 服务器集合，每个代理都有可能拥有大量的工具来执行各种任务。

想要帮忙吗？

如果您喜欢这个想法并且精通 TypeScript；我可以利用您的帮助！如果您想贡献，请联系我。

概述

Skynet-MCP 是一个先进的架构，它实现了模型上下文协议 (MCP) 来创建一个 AI 代理的分层网络。每个 Skynet-MCP 实例都充当 MCP 服务器和 MCP 客户端，使其能够向父代理提供工具，同时生成和管理子代理。

这种架构支持递归代理网络，能够分解复杂任务、并行化工作以及集成跨多个模型和服务的专业功能。

特性

• 双模式运行: 既充当 MCP 服务器又充当客户端
• LLM 集成: 连接到 OpenAI 或 Anthropic 模型以进行智能决策
• 工具发现: 自动发现和使用来自连接的 MCP 服务器的工具
• 分层代理管理: 创建和管理子代理
• 可配置: 灵活的配置系统，支持多种环境
• FastMCP 集成: 构建在高效的 FastMCP 框架之上，用于强大的 MCP 服务器实现
• 多种传输选项: 支持 STDIO 和 SSE（服务器发送事件）传输
• 延迟执行: 异步运行任务并在以后轮询结果

MCP 工具

Skynet-MCP 通过其 FastMCP 实现提供以下 MCP 工具：

1. Invoke: 创建和管理代理任务

   • 参数：
     • mcpConfig: MCP 服务器配置（代理可用的工具）
     • llmConfig: LLM 配置（要使用的提供程序和模型）
     • prompt: 代理任务的指令
     • delayedExecution: 布尔值，指示是否应异步运行任务

2. DelayedResponse: 检索异步任务的结果

   • 参数：
     • taskId: 要检查的任务的 ID
   • 返回：任务状态和结果（如果已完成）

代理

代理框架仍需要实现。

项目结构

skynet-mcp/
├── src/
│   ├── server/       # MCP 服务器实现
│   ├── client/       # MCP 客户端实现
│   ├── orchestrator/ # 代理编排
│   ├── tools/        # 代理工具
│   ├── persistence/  # 状态管理
│   └── utils/        # 共享实用程序
├── test/
│   ├── unit/         # 单元测试
│   └── integration/  # 集成测试
├── examples/         # 示例实现
└── config/           # 配置文件

开发

前提条件

• Node.js (v20+)
• npm
• Docker 和 Docker Compose（可选，用于容器化开发）
• OpenAI 或 Anthropic 的 API 密钥（用于 LLM 驱动的代理）

设置

1. 克隆存储库
2. 安装依赖项：

   npm install
   

可用脚本

基本开发命令

• npm run build - 构建项目
• npm run test - 运行测试
• npm run test:watch - 在监视模式下运行测试
• npm run test:coverage - 运行带有覆盖率的测试
• npm run lint - 检查代码风格
• npm run lint:fix - 检查并修复代码风格
• npm run format - 格式化代码
• npm run dev - 在监视模式下运行 TypeScript
• npm start - 启动应用程序

Docker 命令

• npm run docker:build - 构建 Docker 镜像
• npm run docker:up - 使用 Docker Compose 启动应用程序
• npm run docker:down - 停止 Docker Compose 服务
• npm run docker:test - 在 Docker 容器内运行测试
• npm run test:docker - 运行特定于 Docker 的测试（需要 Docker 运行）

Docker 支持

Skynet-MCP 包括 Docker 支持，用于容器化开发和部署。

Dockerfile

该项目包含一个 Dockerfile，它：

• 使用 Node.js 20 Alpine 作为基础镜像
• 设置应用程序环境
• 安装依赖项
• 构建 TypeScript 代码
• 公开服务器的 3000 端口

Docker Compose

docker-compose.yml 文件提供了一个完整的开发环境，包括：

• Skynet-MCP 应用程序容器
• Redis 用于状态管理和持久性
• 用于本地开发的卷挂载
• 环境变量配置

要启动完整的环境：

npm run docker:up

配置系统

Skynet-MCP 使用灵活的配置系统，可以从以下位置加载设置：

• 默认值
• 环境变量
• 特定于环境的 JSON 配置文件

配置文件存储在 config/ 目录中，并根据 NODE_ENV 环境变量加载。

环境变量

关键环境变量包括：

• SERVER_PORT - 服务器监听的端口
• SERVER_HOST - 服务器绑定的主机
• LOG_LEVEL - 日志记录级别（debug、info、warn、error）
• PERSISTENCE_TYPE - 存储类型（内存或 redis）
• REDIS_URL - Redis 连接 URL（使用 Redis 时）
• OPENAI_API_KEY - OpenAI API 密钥（用于 LLM 驱动的代理）
• ANTHROPIC_API_KEY - Anthropic API 密钥（用于 LLM 驱动的代理）

CI/CD

Skynet-MCP 使用 GitHub Actions 进行持续集成和交付。

工作流程：

1. 在推送到主分支和拉取请求时运行
2. 设置 Node.js 环境
3. 安装依赖项
4. 运行代码风格检查和格式化检查
5. 构建项目
6. 运行所有测试
7. 构建并验证 Docker 镜像

CI/CD 管道通过在合并更改之前自动测试更改来帮助确保代码质量和稳定性。

许可证

ISC