Skip to main content
Glama
mbpfws

Sentient Brain Smithery

by mbpfws
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

🧠 Sentient Brain Multi-Agent System for Smithery.ai

Advanced AI Code Developer with Multi-Agent Architecture 🚀

Last deployment: 2025-01-27

Advanced AI Code Developer system leveraging multi-agent architecture with SurrealDB unified data layer. Designed for seamless deployment on Smithery.ai platform.

🚀 Features

  • Ultra Orchestrator: Master agent coordinating multi-agent workflows

  • Architect Agent: Intelligent project design and planning

  • Code Analysis: Deep code understanding and semantic indexing

  • Knowledge Graph: Unified memory layer with semantic search

  • Debug & Refactor: Intelligent code improvement and error resolution

  • Failure Prevention: Advanced mechanisms to prevent common AI failures

🏗️ Architecture

Multi-Agent Framework

  • Ultra Orchestrator: Routes tasks and manages agent coordination

  • Architect Agent: Handles project planning and design

  • Code Analysis Agent: Provides deep code understanding

  • Knowledge Search Agent: Semantic search across project knowledge

  • Debug & Refactor Agent: Code improvement and error resolution

Technology Stack

  • Runtime: Python 3.11+ with FastAPI

  • Database: SurrealDB for unified data layer

  • LLM: Groq API for high-performance inference

  • Framework: LangGraph for agent workflows

  • Protocol: MCP (Model Context Protocol) compatible

📦 Smithery.ai Deployment

This package is optimized for deployment on Smithery.ai platform using the Custom Deploy method.

Prerequisites

  • Smithery.ai account

  • GitHub repository

  • Required API keys (Groq, optional Google)

Deployment Steps

  1. Repository Setup

    git clone <your-repo> cd sentient-brain-smithery

  2. Configuration

    • Ensure smithery.yaml and Dockerfile are in root

    • Configure required environment variables in Smithery dashboard

  3. Deploy on Smithery

    • Connect your GitHub repository to Smithery

    • Navigate to Deployments tab

    • Click "Deploy" to build and host your container

Required Configuration

Variable

Description

Required

Default

GROQ_API_KEY

Groq API key for LLM inference

Yes

-

SURREAL_URL

SurrealDB connection URL

Yes

ws://localhost:8000/rpc

SURREAL_USER

SurrealDB username

Yes

root

SURREAL_PASS

SurrealDB password

Yes

root

GOOGLE_API_KEY

Google GenAI API key

No

-

🛠️ Available Tools

Core Tools

  1. sentient-brain/orchestrate

    • Master coordination and workflow management

    • Analyzes user intent and routes to appropriate agents

  2. sentient-brain/architect

    • Project design and architecture planning

    • Technology stack recommendations

  3. sentient-brain/analyze-code

    • Deep code analysis and understanding

    • Structure, quality, and dependency analysis

  4. sentient-brain/search-knowledge

    • Semantic search across project knowledge graph

    • Multi-modal search (code, docs, concepts)

  5. sentient-brain/debug-assist

    • Intelligent debugging and code improvement

    • Error resolution and refactoring suggestions

🔧 Usage Examples

Basic Orchestration

{ "tool": "sentient-brain/orchestrate", "arguments": { "query": "I want to build a REST API for user authentication", "context": { "project_type": "web_api", "tech_stack": ["python", "fastapi"] } } }

Project Architecture

{ "tool": "sentient-brain/architect", "arguments": { "project_type": "web_api", "requirements": "User authentication with JWT tokens", "tech_stack": ["python", "fastapi", "postgresql"] } }

Knowledge Search

{ "tool": "sentient-brain/search-knowledge", "arguments": { "query": "authentication middleware implementation", "node_type": "code_chunk", "limit": 10 } }

🔍 Health Check

The server provides a health check endpoint:

  • GET / - Basic server status

  • GET /mcp - MCP protocol info and available tools

🐛 Debugging

Common Issues

  1. Connection Issues

    • Verify SurrealDB connection parameters

    • Check network connectivity

  2. API Key Issues

    • Ensure Groq API key is valid and has sufficient credits

    • Verify API key format and permissions

  3. Configuration Issues

    • Check Smithery configuration parameters

    • Verify environment variable mapping

Logs

The server uses structured logging with configurable levels:

  • DEBUG: Detailed debugging information

  • INFO: General operational messages

  • WARNING: Warning messages

  • ERROR: Error conditions

📈 Performance

  • Optimized Docker: Multi-stage build for minimal image size

  • Async Operations: Full async/await support for high concurrency

  • Caching: Intelligent caching for frequently accessed data

  • Connection Pooling: Efficient database connection management

🔒 Security

  • Non-root User: Container runs as non-privileged user

  • Input Validation: Comprehensive input validation using Pydantic

  • Rate Limiting: Built-in rate limiting for API endpoints

  • Secure Defaults: Security-first configuration defaults

📚 Documentation

🤝 Support

📄 License

MIT License - see LICENSE file for details.

Ready for Smithery.ai deployment! 🚀

🇻🇳 Tài liệu Tiếng Việt

🧠 Công cụ Cốt lõi

  1. sentient-brain/orchestrate

    • Điều phối chính và quản lý luồng công việc

    • Phân tích ý định người dùng và chuyển tiếp đến các agent phù hợp

  2. sentient-brain/architect

    • Thiết kế dự án và lập kế hoạch kiến trúc

    • Đề xuất lựa chọn công nghệ

  3. sentient-brain/analyze-code

    • Phân tích mã nguồn sâu và hiểu mã

    • Phân tích cấu trúc, chất lượng và phụ thuộc

  4. sentient-brain/search-knowledge

    • Tìm kiếm ngữ nghĩa trên đồ thị tri thức dự án

    • Tìm kiếm đa phương tiện (mã nguồn, tài liệu, khái niệm)

  5. sentient-brain/debug-assist

    • Gỡ lỗi thông minh và nâng cao chất lượng mã

    • Gợi ý sửa lỗi và refactor

🔧 Ví dụ Sử Dụng

Điều phối cơ bản

{ "tool": "sentient-brain/orchestrate", "arguments": { "query": "Tôi muốn xây dựng REST API cho xác thực người dùng", "context": { "project_type": "web_api", "tech_stack": ["python", "fastapi"] } } }

Thiết kế Kiến trúc Dự án

{ "tool": "sentient-brain/architect", "arguments": { "project_type": "web_api", "requirements": "Xác thực người dùng bằng JWT", "tech_stack": ["python", "fastapi", "postgresql"] } }

Tìm kiếm Tri thức

{ "tool": "sentient-brain/search-knowledge", "arguments": { "query": "triển khai middleware xác thực", "node_type": "code_chunk", "limit": 10 } }

🔍 Kiểm tra Sức khỏe

Máy chủ cung cấp các endpoint kiểm tra sức khỏe:

  • GET / - Kiểm tra trạng thái cơ bản

  • GET /mcp - Thông tin giao thức MCP và danh sách công cụ khả dụng

🐛 Gỡ Lỗi

Các Vấn Đề Thường Gặp

  1. Kết nối đến CSDL

    • Kiểm tra lại thông tin kết nối SurrealDB

    • Xác nhận kết nối mạng

  2. Vấn đề API Key

    • Đảm bảo API key Groq hợp lệ và còn hạn mức sử dụng

    • Kiểm tra định dạng và quyền truy cập của API key

  3. Vấn đề Cấu hình

    • Kiểm tra lại các tham số cấu hình Smithery

    • Đảm bảo ánh xạ biến môi trường chính xác

Ghi log

Máy chủ sử dụng logging có cấu trúc với các mức độ cấu hình:

  • DEBUG: Thông tin gỡ lỗi chi tiết

  • INFO: Thông báo hoạt động chung

  • WARNING: Cảnh báo

  • ERROR: Lỗi nghiêm trọng

📈 Hiệu Năng

  • Docker tối ưu: Multi-stage build giúp giảm kích thước image

  • Hoạt động bất đồng bộ: Hỗ trợ async/await cho hiệu suất cao

  • Bộ nhớ đệm: Cache thông minh cho dữ liệu truy cập thường xuyên

  • Kết nối pooling: Quản lý kết nối CSDL hiệu quả

🔒 Bảo Mật

  • Chạy không quyền root: Container chạy bằng user không đặc quyền

  • Kiểm tra đầu vào: Sử dụng Pydantic để kiểm tra dữ liệu vào

  • Giới hạn tốc độ: Tích hợp rate limiting cho các endpoint

  • Cấu hình an toàn mặc định: Ưu tiên bảo mật từ đầu

📚 Tài liệu

🤝 Hỗ trợ

📄 Giấy phép

MIT License - xem file LICENSE để biết chi tiết.

Sẵn sàng triển khai trên Smithery.ai! 🚀

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mbpfws/sentient-brain-smithery'

If you have feedback or need assistance with the MCP directory API, please join our Discord server