BRAINS OS - version MCP
@groovysquirrel
A Serverless MCP implementation using SST, React and AWS.
Overview
What is BRAINS OS - version MCP?
A modern, serverless operating system for AI systems and agents, built with SST, React, and TypeScript. It provides a robust framework for managing Large Language Models (LLMs) and specialized AI agents through the MCP (Model Control Protocol) with a unified command system and shared operating template.
How to use BRAINS OS - version MCP?
Clone the repository, install dependencies with npm install, and start the development server using npx sst dev. Configure test environment by copying .env.test.example to .env.test and setting AWS Cognito credentials, then run test scripts located in packages/brainsOS/test_scripts/mcp/.
Key features of BRAINS OS - version MCP
- Visual flow editor for AI workflow design
- Unified command system for AI operations
- Secure authentication and authorization (AWS Cognito)
- Real-time workflow execution
- Comprehensive audit logging
- Serverless architecture on AWS Lambda and DynamoDB
Use cases of BRAINS OS - version MCP
- Orchestrate and visually design AI workflows
- Securely deploy and manage specialized AI subminds
- Maintain strict data ownership and audit trails
- Manage prompts and benchmark AI performance
- Enable scalable, cloud-native AI agent operations
FAQ from BRAINS OS - version MCP
What are the prerequisites to run BRAINS OS - version MCP?
You need Node.js v16 or later, an AWS account with configured credentials, and Git.
What cloud services does BRAINS OS - version MCP use?
It uses AWS Lambda for backend functions, AWS Cognito for authentication, DynamoDB for database, and SST (Serverless Stack) for infrastructure management.
How can I contribute to BRAINS OS - version MCP?
Fork the repository, create a feature branch, commit changes, and open a Pull Request.
How do I keep test credentials secure?
Never commit .env.test to version control, set file permissions to 600 (chmod 600 .env.test), rotate credentials regularly, and use separate test credentials from production.
What test scripts are available?
Test scripts are organized under packages/brainsOS/test_scripts/ with subdirectories for MCP, resources, and services. You can run individual suites like ./packages/brainsOS/test_scripts/mcp/test_tools.sh with options to start from a specific step.
