![MCP Logo](mcp.png) # Cursor Buddy MCP **🤖 Keep AI Agents Context-Aware & Consistent** [![Docker](https://img.shields.io/badge/docker-ready-blue?logo=docker&logoColor=white)](https://github.com/omar-haris/cursor-buddy-mcp/pkgs/container/cursor-buddy-mcp) [![Go](https://img.shields.io/badge/Go-1.23+-00ADD8?logo=go&logoColor=white)](https://golang.org/) [![MCP](https://img.shields.io/badge/MCP-Compatible-green?logo=github&logoColor=white)](https://modelcontextprotocol.io) [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) *Transform your AI assistant into a context-aware coding partner that understands your project's standards, conventions, and history.* [🚀 Quick Start](#-quick-start) • [📚 Documentation](#-documentation) • [🔧 Tools](#-available-tools) • [💡 Examples](#-usage-examples)

--- ## 🎯 Why Cursor Buddy MCP?

### 🧠 **Context-Aware AI** Your AI assistant instantly knows your coding standards, architectural patterns, and project conventions ### 📚 **Centralized Knowledge** All project documentation and guidelines in one searchable location ### ✅ **Progress Tracking** Automatic todo management and implementation history tracking

### 🔄 **Real-time Updates** File monitoring ensures your AI always has the latest information ### 🚀 **Zero Setup Friction** Drop-in Docker container with immediate MCP integration ### 🔍 **Intelligent Search** Fast, relevant results across all your project context

--- ## 📋 Table of Contents - [🎯 Why Cursor Buddy MCP?](#-why-cursor-buddy-mcp) - [🏗️ Architecture](#️-architecture) - [🚀 Quick Start](#-quick-start) - [🔧 Available Tools](#-available-tools) - [💡 Usage Examples](#-usage-examples) - [📚 Documentation](#-documentation) - [📋 Rules Files](#-rules-files) - [📖 Knowledge Files](#-knowledge-files) - [✅ Todo Files](#-todo-files) - [🗄️ Database Files](#️-database-files) -