BRAINS OS - 版本 MCP

一个现代的、无服务器的操作系统，专为 AI 系统和代理而设计，使用 SST、React 和 TypeScript 构建。该项目提供了一个强大的框架，通过 MCP（模型控制协议）以统一的命令系统和共享的操作模板来管理大型语言模型（LLM）和专业的 AI 代理。

概述

Brains MCP 旨在：

• 通过可视化界面管理和编排 AI 工作流程
• 为 AI 操作提供统一的命令系统
• 实现 AI 子模块的安全、可扩展部署
• 支持全面的提示管理和基准测试
• 维护严格的数据所有权和审计能力

主要特性

当前版本

• 用于 AI 工作流程设计的可视化流程编辑器
• 用于 AI 操作的统一命令系统
• 安全的身份验证和授权
• 实时工作流程执行
• 全面的审计日志记录

即将推出

• 具有基准测试功能的高级提示库
• MCP（模型控制协议）客户端/服务器实现
• 增强的状态管理和持久性
• 扩展的模型支持和集成
• 高级模板系统

架构

该系统构建在现代云原生技术之上：

• 前端: 使用 TypeScript 和基于 Flow 的 UI 的 React
• 后端: AWS Lambda 函数
• 身份验证: AWS Cognito
• 数据库: DynamoDB
• 基础设施: SST (Serverless Stack)

快速开始

前提条件

• Node.js (v16 或更高版本)
• 配置了凭证的 AWS 账户
• Git

安装

1. 克隆存储库：

   git clone [repository-url]
   cd brains-mcp
   

2. 安装依赖项：

   npm install
   

3. 启动开发服务器：

   npx sst dev
   

测试环境设置

1. 创建您的测试环境文件：

   cp .env.test.example .env.test
   chmod 600 .env.test  # 设置安全的文件权限
   

2. 通过编辑 .env.test 配置您的测试环境：

   # API 配置
   API_STAGE=dev
   API_VERSION=latest
   API_BASE_URL=https://dev-api.yoururl-in-aws-route53.com
   
   # AWS Cognito 身份验证 (必需)
   COGNITO_USERNAME=your_test_username@example.com
   COGNITO_PASSWORD=your_test_password
   USER_POOL_ID=us-east-1_xxxxxx
   APP_CLIENT_ID=xxxxxxxxxxxxxxxxxx
   COGNITO_REGION=us-east-1
   IDENTITY_POOL_ID=us-east-1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
   API_GATEWAY_REGION=us-east-1
   

3. 验证您的测试设置：

   # 运行一个基本测试来验证配置
   ./packages/brainsOS/test_scripts/mcp/test_tools.sh
   

安全注意事项

• 永远不要将 .env.test 提交到版本控制
• 保持测试凭证安全并定期轮换它们
• 确保 .env.test 具有正确的权限 (600)
• 检查测试脚本中是否有任何硬编码的敏感数据
• 使用与生产环境分离的测试凭证

测试脚本组织

packages/brainsOS/test_scripts/
├── mcp/                    # MCP 特定的测试脚本
├── resources/             # 资源 API 测试脚本
├── services/             # 服务 API 测试脚本
└── test_utils.sh         # 通用测试实用程序

运行测试

1. 单独的测试脚本：

   # 运行特定的测试套件
   ./packages/brainsOS/test_scripts/mcp/test_tools.sh
   
   # 从特定的起点运行
   ./packages/brainsOS/test_scripts/mcp/test_tools.sh -5  # 从第 5 步开始
   

2. 交互式功能：

   • 按 [Enter] 继续到下一个测试
   • 按 [R] 重试上一个命令
   • 按 [Q] 退出测试套件

3. 查看结果：

   • ✅ 表示通过的测试
   • ❌ 表示失败的测试
   • ⚠️ 表示警告或重要通知

故障排除

1. 权限问题：

   # 重置文件权限
   chmod 600 .env.test
   chmod 755 packages/brainsOS/test_scripts/*.sh
   

2. 身份验证错误：

   • 验证 .env.test 中的 Cognito 凭证
   • 检查 API 端点配置
   • 确保 AWS 区域设置正确

3. 常见问题：

   • Token 过期：脚本会自动处理
   • 速率限制：内置延迟可防止 API 限制
   • 缺少环境变量：验证会捕获这些

项目结构

brains-mcp/
├── packages/
│   ├── frontend/           # 基于 React 的流程编辑器
│   │   ├── src/
│   │   │   ├── components/
│   │   │   ├── nodes/
│   │   │   └── core/
│   │   └── ...
│   └── brainsOS/          # 核心后端系统
│       ├── commands/      # 命令实现
│       ├── core/         # 核心服务
│       ├── functions/    # API 函数
│       └── utils/        # 共享实用程序
├── infra/                # 基础设施代码
└── sst.config.ts        # SST 配置

开发

本地开发

npx sst dev

部署

npx sst deploy --stage <stage>

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

许可证

[许可证类型] - 有关详细信息，请参见 LICENSE 文件