{"id":29848559,"url":"https://github.com/bralca/context-engineering-mcp","last_synced_at":"2025-07-29T19:46:12.641Z","repository":{"id":306988080,"uuid":"1027955471","full_name":"bralca/context-engineering-mcp","owner":"bralca","description":"Context Engineering is a MCP server that gives AI agents perfect understanding of your codebase. Eliminates context loss, reduces token usage, and generates comprehensive feature plans in minutes. Compatible with Cursor, Claude Code, and VS Code.","archived":false,"fork":false,"pushed_at":"2025-07-28T19:44:11.000Z","size":26,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-28T21:38:17.774Z","etag":null,"topics":["ai","ai-agents","ai-tools","claude-code","cursor","mcp-server","model-context-protocol"],"latest_commit_sha":null,"homepage":"https://contextengineering.ai/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bralca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-28T19:42:12.000Z","updated_at":"2025-07-28T19:46:11.000Z","dependencies_parsed_at":"2025-07-28T21:38:19.356Z","dependency_job_id":"3c0db07d-fcc1-4cee-be92-c0a567230d25","html_url":"https://github.com/bralca/context-engineering-mcp","commit_stats":null,"previous_names":["bralca/context-engineering-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bralca/context-engineering-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bralca%2Fcontext-engineering-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bralca%2Fcontext-engineering-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bralca%2Fcontext-engineering-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bralca%2Fcontext-engineering-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bralca","download_url":"https://codeload.github.com/bralca/context-engineering-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bralca%2Fcontext-engineering-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267746330,"owners_count":24137992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-tools","claude-code","cursor","mcp-server","model-context-protocol"],"created_at":"2025-07-29T19:46:11.601Z","updated_at":"2025-07-29T19:46:12.623Z","avatar_url":"https://github.com/bralca.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Context Engineering - MCP Server for Cursor, Claude Code \u0026 VS Code\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eFrom Idea to Production without Context Loss\u003c/strong\u003e\u003cbr/\u003e\n  Give AI agents perfect understanding of your tech stack, architecture and established patterns.\u003cbr/\u003e\n  Build complex features \u003cstrong\u003e10X more productive\u003c/strong\u003e.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://contextengineering.ai\"\u003e\u003cimg src=\"https://img.shields.io/badge/Website-contextengineering.ai-blue?style=for-the-badge\" alt=\"Website\"\u003e\u003c/a\u003e\n  \u003ca href=\"#installation\"\u003e\u003cimg src=\"https://img.shields.io/badge/MCP-Compatible-green?style=for-the-badge\" alt=\"MCP Compatible\"\u003e\u003c/a\u003e\n  \u003ca href=\"#supported-platforms\"\u003e\u003cimg src=\"https://img.shields.io/badge/Supports-Cursor%20%7C%20Claude%20Code%20%7C%20VS%20Code-purple?style=for-the-badge\" alt=\"Platform Support\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🎯 What is Context Engineering?\n\n**Context Engineering** is the practice of giving AI agents comprehensive understanding of your codebase, architecture, and development patterns. Our **MCP (Model Context Protocol) server** eliminates context loss that typically occurs when AI agents work on complex software projects.\n\n### ⚡ The Problem We Solve\n\n- **Context Loss**: AI agents lose track of your project's architecture across conversations\n- **Inconsistent Patterns**: AI generates code that doesn't follow your established conventions  \n- **Manual Explanations**: Repeatedly explaining your tech stack and project structure\n- **Feature Complexity**: Building sophisticated features requires deep codebase understanding\n\n### 🎉 The Context Engineering Solution\n\nOur MCP server provides AI agents with:\n- **Perfect Tech Stack Understanding** - Automatically analyzes your project dependencies and architecture\n- **Codebase Pattern Recognition** - Learns your coding styles, naming conventions, and file structures  \n- **Feature Planning Intelligence** - Generates comprehensive PRDs, technical blueprints, and implementation tasks\n- **Cross-Platform Compatibility** - Works seamlessly with Cursor, Claude Code, VS Code, and any MCP-compatible IDE\n\n## 🚀 Key Features\n\n### 🧠 **Intelligent Feature Categorization**\n- **8 Smart Categories**: Landing pages, UI components, APIs, performance, analytics, auth, data management, integrations\n- **Automatic LLM Analysis**: Instantly categorizes your feature requests with confidence scoring\n- **Tailored Planning Workflows**: Each category gets specialized questions and implementation guidance\n- **Multi-Category Support**: Handles complex features spanning multiple domains\n\n### 📋 **Automated Documentation Generation**\n- **Comprehensive PRDs**: Product Requirements Documents with user stories and acceptance criteria\n- **Technical Blueprints**: Architecture diagrams, API specs, and implementation phases  \n- **Detailed Task Lists**: 40+ actionable development tasks with priority levels\n- **Risk Assessment**: Identifies potential blockers and mitigation strategies\n\n### 🏗️ **Advanced Codebase Analysis**\n- **Tech Stack Detection**: Automatically identifies React, Vue, Express, Django, Rails, and more\n- **Architecture Patterns**: Recognizes MVC, microservices, monoliths, and component structures\n- **Database Integration**: Maps existing schemas, APIs, and authentication patterns\n- **Legacy System Support**: Understands complex, multi-layer applications\n\n---\n\n## 🛠️ Supported Platforms\n\n### ✅ Fully Compatible IDEs\n\n| IDE | Status | Installation Guide |\n|-----|--------|-------------------|\n| **[Cursor](https://cursor.sh/)** | ✅ Full Support | [Cursor MCP Setup](#cursor-setup) |\n| **[Claude Code](https://claude.ai/code)** | ✅ Full Support | [Claude Code MCP Setup](#claude-code-setup) |\n| **[VS Code](https://code.visualstudio.com/)** | ✅ Full Support | [VS Code MCP Setup](#vs-code-setup) |\n| **[Zed](https://zed.dev/)** | 🔄 Coming Soon | [Request Support](https://github.com/yourusername/context-engineer/issues) |\n| **[JetBrains IDEs](https://www.jetbrains.com/)** | 🔄 Coming Soon | [Request Support](https://github.com/yourusername/context-engineer/issues) |\n\n*Works with any IDE that supports the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)*\n\n---\n\n## 🎯 Use Cases\n\n### 🏢 **Enterprise Development**\n- **Large Codebases**: Maintain context across million-line projects\n- **Team Consistency**: Ensure all developers follow established patterns\n- **Legacy Migration**: Understand and modernize complex legacy systems\n- **Microservices**: Coordinate development across multiple services\n\n### 🚀 **Startup Velocity** \n- **Rapid Prototyping**: Build MVPs 10X faster with intelligent feature planning\n- **Technical Debt Management**: Maintain code quality during rapid iteration\n- **Full-Stack Development**: Single developer can handle complex, multi-layer features\n- **Product Management**: Generate comprehensive technical specifications\n\n### 🔧 **Open Source Projects**\n- **Contributor Onboarding**: New contributors understand project structure instantly  \n- **Documentation Generation**: Auto-generate technical documentation from codebase\n- **Feature Roadmapping**: Plan complex features with detailed implementation guides\n- **Code Review Assistance**: Ensure contributions follow project conventions\n\n---\n\n## 🏗️ Architecture\n\n### Model Context Protocol (MCP) Integration\nContext Engineer implements the **Model Context Protocol**, enabling seamless communication between AI agents and your development environment.\n\n```mermaid\ngraph TD\n    A[Your IDE] --\u003e B[MCP Client]\n    B --\u003e C[Context Engineer MCP Server]\n    C --\u003e D[Codebase Analyzer]\n    C --\u003e E[Pattern Recognition Engine]  \n    C --\u003e F[Feature Planning AI]\n    D --\u003e G[Your Project Files]\n    E --\u003e G\n    F --\u003e H[Generated Documentation]\n```\n\n### Core Components\n- **🔍 Codebase Analyzer**: Deep inspection of project structure and dependencies\n- **🧩 Pattern Recognition Engine**: Learns coding styles and architectural decisions\n- **📋 Feature Planning AI**: Generates comprehensive development documentation  \n- **🔌 MCP Interface**: Standards-compliant protocol implementation\n\n---\n\n## 📊 Performance Benefits\n\n| Metric | Before Context Engineering | After Context Engineering | Improvement |\n|--------|---------------------------|---------------------------|-------------|\n| **Feature Planning Time** | 4-8 hours | 15-30 minutes | **10-16X faster** |\n| **Context Switching** | Every conversation | Never | **100% elimination** |\n| **Code Consistency** | Manual reviews required | Automatic adherence | **Zero rework** |\n| **Documentation Quality** | Inconsistent, outdated | Comprehensive, current | **Enterprise-grade** |\n\n---\n\n## 🚀 How to Use Context Engineering MCP\n\n### Step 1: Generate Access Key\nVisit [contextengineering.ai](https://contextengineering.ai) and sign up for a free account to generate your unique API key.\n\n### Step 2: Add to Your IDE\n\n#### For Cursor:\n1. Open your Cursor configuration file: `~/.cursor/mcp.json`\n2. Add the following configuration:\n```json\n{\n  \"mcpServers\": {\n    \"context-engineer\": {\n      \"url\": \"https://contextengineering.ai/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-access-key\"\n      }\n    }\n  }\n}\n```\n3. Save the file\n4. Go to Cursor Settings \u003e Tools \u0026 Integrations \u003e MCP Tools \u003e Context Engineer and turn the toggle on\n5. Restart Cursor IDE to apply the changes\n\n#### For Windsurf:\n1. Open your Windsurf configuration file:\n   - Mac/Linux: `~/.windsurf/config.json`\n   - Windows: `%APPDATA%\\Windsurf\\config.json`\n2. Add the following configuration:\n```json\n{\n  \"mcpServers\": {\n    \"context-engineer\": {\n      \"serverUrl\": \"https://contextengineering.ai/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-access-key\"\n      }\n    }\n  }\n}\n```\n3. Save and restart Windsurf\n\n#### For Claude CLI:\nRun this command in your terminal:\n```bash\nclaude mcp add --transport http \"Context-Engineer\" https://contextengineering.ai/mcp --header \"Authorization: Bearer your-access-key\"\n```\n\n### Step 3: Test the Integration\nIn your IDE, type: \"Help me plan a new feature\" to verify the MCP server is connected.\n\n### Step 4: Start Building\nCreate your first feature plan! Try prompts like:\n- \"I want to build an authentication system\"\n- \"Help me create a landing page with analytics\"\n- \"I need to develop an API for user management\"\n\nYour IDE is now ready to create context-rich feature plans that save you hours of development time! 🚀\n\n---\n\n## 💡 Real-World Use Cases \u0026 Examples\n\n### 🎯 When to Use Context Engineering\n\n**Perfect for:**\n- **User Authentication Systems** - Simple idea with many edge cases (OAuth, JWT, session management)\n- **Payment Integration** - Seems straightforward but involves complex security and error handling\n- **File Upload Features** - Easy concept with security, validation, and performance concerns\n- **API Development** - RESTful or GraphQL APIs with proper error handling and documentation\n- **Dashboard \u0026 Analytics** - Complex data visualization with real-time updates\n- **Multi-step Workflows** - Forms, wizards, or any feature touching multiple system parts\n- **Third-party Integrations** - Connecting with external services and APIs\n\n**Examples of Context Engineer in Action:**\n\n1. **\"I want to add Stripe payments to my SaaS\"**\n   - Analyzes your existing user model and database schema\n   - Generates complete payment flow including subscriptions, webhooks, and error handling\n   - Creates 40+ implementation tasks with proper security considerations\n\n2. **\"Help me build a real-time notification system\"**\n   - Maps your current authentication and user management\n   - Plans WebSocket integration with your tech stack\n   - Provides scalability considerations and fallback mechanisms\n\n3. **\"I need to add multi-tenant support to my app\"**\n   - Understands your current database structure\n   - Creates migration strategy preserving existing data\n   - Plans row-level security and tenant isolation\n\n### 📊 Time Savings Analysis\n\nBased on real usage data from building Context Engineer with itself:\n\n| Feature Type | Manual Planning | With Context Engineer | Time Saved |\n|--------------|----------------|----------------------|------------|\n| Authentication System | 4-6 hours | 20 minutes | 93% |\n| Payment Integration | 6-8 hours | 25 minutes | 92% |\n| API Development | 3-4 hours | 15 minutes | 91% |\n| Dashboard Features | 4-5 hours | 20 minutes | 90% |\n| File Management | 2-3 hours | 10 minutes | 89% |\n\n### 🚀 Token Usage Optimization\n\n**Without Context Engineering:**\n- Simple project: ~2,000 tokens (back-and-forth clarifications)\n- Complex enterprise app: ~50,000+ tokens (extensive context sharing)\n- Token usage grows exponentially with project complexity\n\n**With Context Engineering:**\n- Any project complexity: ~500 tokens (one-shot planning)\n- Predictable token usage regardless of codebase size\n- 10-50x reduction in token consumption for complex projects\n\n### 🏗️ Works Especially Well With Complex Codebases\n\nContext Engineering shines with:\n- ✅ Large monorepos with multiple services\n- ✅ Legacy codebases with technical debt\n- ✅ Projects with custom frameworks\n- ✅ Multi-language applications\n- ✅ Microservices architectures\n- ✅ Systems with complex business logic\n\nThe messier your codebase, the more value Context Engineering provides by automatically mapping complexity you'd struggle to explain manually.\n\n### 🔄 Seamless Workflow Integration\n\n**Your Current Flow:**\n1. Idea → 2. Manual Planning → 3. Coding → 4. Debug/Refine\n\n**With Context Engineering:**\n1. Idea → 2. AI Planning (instant) → 3. Coding → 4. Ship faster\n\nZero disruption - Context Engineering enhances your existing workflow without changing how you code.\n\n---\n\n## ❓ Frequently Asked Questions\n\n**Q: What counts as a \"tool call\"?**\nA: Each action Context Engineer performs - analyzing code, generating PRD sections, or creating tasks. The free tier's 10 calls typically cover 1-2 complete feature planning sessions.\n\n**Q: Will this work with my tech stack?**\nA: Yes! Context Engineering is tech-stack agnostic. It works by understanding code patterns and structure, not specific technologies. Currently excels with JavaScript/TypeScript, Python, and most modern frameworks.\n\n**Q: Is this overkill for simple features?**\nA: Even \"simple\" features often have hidden complexity. A basic login page might need validation, error handling, security, and database integration. Context Engineering ensures nothing is missed.\n\n**Q: How does this save me tokens?**\nA: Instead of multiple back-and-forth conversations explaining your codebase, Context Engineering provides perfect context upfront. This reduces token usage by 10-50x for complex projects.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbralca%2Fcontext-engineering-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbralca%2Fcontext-engineering-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbralca%2Fcontext-engineering-mcp/lists"}