Brain Server - MCP Knowledge Embedding Service

A powerful MCP (Model Context Protocol) server for managing knowledge embeddings and vector search.

Features

• Vector Embeddings: Generate high-quality embeddings for knowledge content
• Semantic Search: Find knowledge based on meaning, not just keywords
• MCP Compliance: Follows Model Context Protocol for AI integration
• Brain Management: Organize knowledge into domain-specific brains
• Context-Aware Retrieval: Includes surrounding context for better understanding
• Progress Tracking: Real-time monitoring of long-running operations

Installation

# Clone the repository
git clone https://github.com/your-username/brain-server.git
cd brain-server

# Install dependencies
npm install

# Configure environment 
cp .env.example .env
# Edit .env with your settings

# Build the project
npm run build

Configuration

Configure the server using environment variables in the .env file:

# Server Configuration
PORT=3000

# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017

# Model Configuration
EMBEDDING_MODEL=Xenova/all-MiniLM-L6-v2
MAX_CHUNK_SIZE=1024

Usage

Starting the Server

# Development mode
npm run dev

# Production mode
npm start

MCP Tool Usage

The server exposes the following MCP tools:

• addKnowledge: Add new knowledge to the vector database
• searchSimilar: Find semantically similar content
• updateKnowledge: Update existing knowledge entries
• deleteKnowledge: Remove knowledge entries
• batchAddKnowledge: Add multiple knowledge entries in a batch
• getEmbedding: Generate embeddings for text content

Development

Project Structure

src/
├── config/          # Configuration settings
├── controllers/     # Route controllers
├── errors/          # Error definitions
├── middleware/      # Express middleware
├── models/          # Data models and types
├── services/        # Business logic
│   ├── embeddings/  # Embedding providers
│   ├── ingestion/   # Knowledge ingestion
│   ├── processing/  # Knowledge processing
│   └── storage/     # Storage services
├── tools/           # MCP tool definitions
├── types/           # TypeScript type definitions
├── utils/           # Utility functions
├── server.ts        # MCP server setup
└── index.ts         # Application entry point

Available Scripts

• npm run build: Build the TypeScript project
• npm start: Run the built application
• npm run dev: Run in development mode with hot reloading
• npm test: Run tests
• npm run lint: Run linter

License

This project is licensed under the ISC License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.