mcpbee

MCPBee

Simplified MCP Architecture for Claude Code

Clean, efficient AI orchestration without the complexity

"Built with simplicity as a feature"

What is MCPBee?

MCPBee is a lightweight MCP (Model Context Protocol) server that connects your codebase to Claude Code with intelligent pattern learning. Unlike complex enterprise orchestration systems, MCPBee focuses on what matters:

• 🧠 Knowledge Storage - Remembers solutions and patterns that work
• 🔌 Native MCP Integration - Works with Claude Code out of the box
• 🎯 Direct Architecture - No layers of abstraction, just clean Go code

Perfect for developers who want AI assistance without enterprise complexity.

Why MCPBee?

Installation

Option 1: Download Binary (Coming Soon)

# Binaries will be available with first release
# macOS/Linux
curl -L https://github.com/garyblankenship/mcpbee/releases/latest/download/mcpbee-$(uname -s)-$(uname -m) -o mcpbee
chmod +x mcpbee
./mcpbee -config config.yaml

Option 2: Install with Go

go install github.com/garyblankenship/mcpbee/cmd/mcpbee@latest
mcpbee -config config.yaml

Option 3: Build from Source

git clone https://github.com/garyblankenship/mcpbee.git
cd mcpbee
go build -o bin/mcpbee ./cmd/mcpbee
./bin/mcpbee -config config.yaml

Quick Start

# Prerequisites
docker run -d -p 6379:6379 redis:alpine  # Start Redis

# Build
go build -o bin/mcpbee ./cmd/mcpbee

# Run MCP server for Claude Code
./bin/mcpbee -config config.yaml

📚 See examples/ for detailed usage and CONTRIBUTING.md to get involved!

Features

🚀 Core Capabilities

• MCP Server - Native Claude Code integration via Model Context Protocol
• Knowledge Store - Redis-backed pattern learning and memory
• File Operations - Read, write, and manage files through MCP tools
• Shell Commands - Execute commands safely with proper validation
• Pattern Learning - Automatically remembers successful solutions

⚡ Performance

• Fast Startup - Under 100ms to operational
• Low Memory - ~23MB runtime footprint
• Direct Architecture - No unnecessary abstraction layers
• Single Binary - Everything in one executable
• Simple Config - One YAML file controls everything

Architecture

User → MCP Server → Service → Redis

Clean, direct communication with minimal overhead. No CQRS, no event buses, no adapter layers - just straightforward Go code that's easy to understand and debug.

Project Structure

mcpbee/
├── cmd/
│   └── mcpbee/              # Main server
├── internal/
│   ├── mcp/                 # MCP server and tools
│   ├── knowledge/           # Pattern storage and learning
│   ├── config/              # Configuration
│   ├── telemetry/           # Usage metrics
│   ├── features/            # Feature flags
│   └── ...                  # Other essential packages
└── config.yaml             # Single configuration file

Configuration

Single config.yaml file:

redis:
  addr: localhost:6379
  
worker:
  process_interval: 100
  
log_level: info

Development

# Run tests
make test

# Format code
make fmt

# Build all
make build-all

# Run with verbose logging
make run-debug

Production Deployment

System Requirements

• Go 1.21+ or Docker
• Redis 6.0+
• 512MB RAM minimum
• Linux/macOS/Windows

Docker Deployment (Coming Soon)

# Docker image will be available after initial release
docker run -d \
  --name mcpbee \
  -v $(pwd)/config.yaml:/config.yaml \
  -e REDIS_ADDR=redis:6379 \
  garyblankenship/mcpbee:latest

Systemd Service

[Unit]
Description=MCPBee MCP Server
After=network.target redis.service

[Service]
Type=simple
User=mcpbee
ExecStart=/usr/local/bin/mcpbee -config /etc/mcpbee/config.yaml
Restart=always

[Install]
WantedBy=multi-user.target

See docs/guides/DEPLOYMENT.md for Kubernetes, cloud deployment, and scaling guides.

Troubleshooting

MCP Tools Not Showing in Claude

1. Restart Claude Code
2. Check .mcp.json exists in project root
3. Verify binary path is absolute
4. Check logs: tail -f ~/.claude/logs/*.log

Redis Connection Failed

# Check Redis is running
redis-cli ping

# If not, start Redis
docker run -d -p 6379:6379 redis:alpine

Build Errors

# Ensure Go 1.21+
go version

# Clean and rebuild
go clean -cache
go build -o bin/mcpbee ./cmd/mcpbee

See docs/TROUBLESHOOTING.md for more solutions.

Philosophy

"Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away." - Antoine de Saint-Exupéry

We removed 70% of the code that provided 0% of the value. The result is faster, cleaner, and more maintainable.

Contributing

We love contributions! See CONTRIBUTING.md for guidelines.

Quick Contribution Guide

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open a Pull Request

Community

• 🐛 Report bugs
• 💡 Request features
• 💬 Join discussions
• ⭐ Star the project

License

MIT - Use it, fork it, improve it!