Cursor Buddy
🤖 MCP server that gives AI agents deep context about your project - coding standards, knowledge base, todos, database schema & history. Keep your AI assistant consistent and context-aware.
What is Cursor Buddy?
Cursor Buddy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🤖 mcp server that gives ai agents deep context about your project - coding standards, knowledge base, todos, database schema & history. keep your ai assistant consistent and context-aware.
🤖 MCP server that gives AI agents deep context about your project - coding standards, knowledge base, todos, database schema & history. Keep your AI assistant consistent and context-aware.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 🤖 MCP server that gives AI agents deep context about your pr
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx cursor-buddyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Cursor Buddy
Cursor Buddy MCP is a Go-based MCP server that runs in Docker and provides AI coding assistants with persistent, structured context about a software project — including coding standards, a searchable knowledge base, todo tracking, database schema information, and implementation history. By mounting a .buddy folder in your project directory, the server gives any MCP-compatible client (Cursor, Claude Desktop, VS Code) a consistent view of project conventions so AI suggestions stay aligned with your team's practices across sessions.
Prerequisites
- Docker installed and running (no local Go build required for normal use)
- Go 1.23+ if building from source
- An MCP-compatible client: Cursor IDE, Claude Desktop, or VS Code with MCP support
- A project directory where you can create the .buddy folder structure
Pull the Docker image
Pull the latest pre-built Cursor Buddy image from the GitHub Container Registry.
docker pull ghcr.io/omar-haris/cursor-buddy-mcp:latestCreate the .buddy directory structure
Inside your project root, create the folder hierarchy that Cursor Buddy uses to store context files.
mkdir -p .buddy/{rules,knowledge,todos,database,history,backups}Populate your context files
Add Markdown files in each subdirectory: coding standards in .buddy/rules/, documentation in .buddy/knowledge/, task lists in .buddy/todos/, and schema files in .buddy/database/. These files become the AI's project knowledge base.
Configure your MCP client
Add the server to your Cursor or Claude Desktop MCP config. The volume mount maps your project's .buddy folder into the container. Replace /path/to/your/project with the absolute path to your project root.
{
"mcpServers": {
"cursor-buddy": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-v", "/path/to/your/project/.buddy:/home/buddy/.buddy",
"-e", "BUDDY_PATH=/home/buddy/.buddy",
"ghcr.io/omar-haris/cursor-buddy-mcp:latest"
]
}
}
}Restart your MCP client
Restart Cursor or Claude Desktop to load the new server configuration. The six Cursor Buddy tools will appear and be available for your AI assistant to call.
Cursor Buddy Examples
Client configuration
Cursor mcp.json config block using Docker to run Cursor Buddy with a volume mount.
{
"mcpServers": {
"cursor-buddy": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-v", "/Users/you/myproject/.buddy:/home/buddy/.buddy",
"-e", "BUDDY_PATH=/home/buddy/.buddy",
"ghcr.io/omar-haris/cursor-buddy-mcp:latest"
]
}
}
}Prompts to try
Example prompts to leverage Cursor Buddy's project context tools.
- "What are our coding standards for error handling in this project?"
- "Show me all open todos for the authentication feature"
- "What is the database schema for the users table?"
- "How did we implement JWT token refresh in this codebase?"
- "Search the knowledge base for anything related to rate limiting"Troubleshooting Cursor Buddy
Docker container exits immediately or tools are not visible in the client
Ensure Docker is running and the image was pulled successfully with 'docker images'. Verify the volume mount path exists on your host machine. The container requires the -i flag to stay attached via stdin/stdout for JSON-RPC communication.
buddy_search_knowledge returns no results for known files
Confirm that Markdown files exist inside .buddy/knowledge/ and that the volume mount path in your config matches the actual .buddy folder location exactly (absolute paths required). Rebuilding from source and checking container logs can reveal file permission issues.
Changes to .buddy files are not reflected after editing
Since files are volume-mounted, changes should be visible immediately without restarting. If stale results appear, check whether your editor created a temp file instead of modifying in place, and confirm the file was saved to the mounted path.
Frequently Asked Questions about Cursor Buddy
What is Cursor Buddy?
Cursor Buddy is a Model Context Protocol (MCP) server that 🤖 mcp server that gives ai agents deep context about your project - coding standards, knowledge base, todos, database schema & history. keep your ai assistant consistent and context-aware. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Cursor Buddy?
Follow the installation instructions on the Cursor Buddy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Cursor Buddy?
Cursor Buddy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Cursor Buddy free to use?
Yes, Cursor Buddy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Cursor Buddy Alternatives — Similar Developer Tools Servers
Looking for alternatives to Cursor Buddy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Cursor Buddy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Cursor Buddy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.