awesomecontext

AwesomeContextThe open-source MCP server that gives Claude Codeinstant access to engineering rules.Architecture patterns, security reviews, coding standards, and compliance checks — retrieved in under 5ms with 96% token savings.122Modules<5msRetrieval96%Token SavingsGet StartedView ToolsHow It WorksThree steps to inject compressed engineering rules into every Claude conversation.Step 01ConfigureSign up and get your API key from the dashboard. Add it to your Claude Code settings — the key is required for cloud access.Copy// .claude/settings.json { "mcpServers": { "awesome-context": { "url": "https://awesomecontext.awareness.market/mcp", "headers": { "Authorization": "Bearer ac_..." } } } }Step 02QueryClaude automatically calls get_rules at the start of every session, loading project-specific coding standards, security rules, and best practices.Copy// Auto-invoked by Claude tools/call: get_rules { "project_type": "react" } // → Returns 5 matched rules // in < 5msStep 03InjectCompressed rules flow into Claude's context as dense prompts — 96% fewer tokens than raw markdown, with zero loss of instruction quality.Copy// Claude's context receives: # Active Rules for: react ## Coding Rules - Component patterns... - Testing standards... - Security guidelines... // 150 tokens vs 4,000+MCP ToolsFour specialized tools that Claude calls automatically during development.get_rulesAuto-invokedLoads project-specific coding standards, security guidelines, and best practices at the start of every conversation.Parametersproject_typestring— Tech stack identifier (e.g. react, python, golang)Copy{ "tool": "get_rules", "arguments": { "project_type": "typescript" } } // Returns: 5 matched rules // Tokens: ~150 (vs 4,000+ raw)architect_consultBefore codingRetrieves architecture patterns, design principles, and domain-specific guidance before writing any code.Parametersintentstring— Design question or task descriptiontop_knumber— Number of modules to retrieve (1-10)Copy{ "tool": "architect_consult", "arguments": { "intent": "design a REST API with auth and rate limiting", "top_k": 5 } }skill_injectorOn demandLoads full implementation details for specific skills — security reviews, TDD workflows, database patterns, and more.Parametersskill_idstring— Skill path (e.g. skills/security-review)Copy{ "tool": "skill_injector", "arguments": { "skill_id": "skills/security-review" } } // Returns: Full security review // checklist and procedurescompliance_verifyBefore commitChecks code against loaded rules for compliance violations, security issues, and anti-patterns before committing.Parameterscodestring— Code snippet or diff to verifyCopy{ "tool": "compliance_verify", "arguments": { "code": "def get_user(id): query = f'SELECT * FROM users WHERE id={id}' ..." } } // → Flags SQL injection riskExamplesSee how Claude interacts with AwesomeContext during real development workflows.Architecture QuerySkill InjectionCompliance CheckBefore committing, Claude checks your code against loaded rules — catching SQL injection, XSS, and anti-patterns.RequestCopy// Claude auto-calls before commit: tools/call: compliance_verify { "code": "def get_user(user_id): query = f'SELECT * FROM users WHERE id = {user_id}' cursor.execute(query) return cursor.fetchone()" }ResponseCopy// AwesomeContext returns: { "dense_prompt": "COMPLIANCE VIOLATIONS FOUND: [CRITICAL] SQL Injection Line 2: f-string in SQL query Fix: Use parameterized queries cursor.execute( 'SELECT * FROM users WHERE id=?', (user_id,)) [WARNING] No input validation Add type check for user_id [INFO] Missing error handling Wrap in try/except with logging", "metrics": { "tokens_saved": 2340, "retrieval_time_ms": 1.1 } }Quick StartStart using AwesomeContext in under a minute. Choose cloud or self-hosted.CloudRecommendedSign up for a free API key, add it to your Claude Code settings, and start coding.1. Get your API keySign up and generate an API key from the dashboard.2. Add to Claude Code settingsCopy{ "mcpServers": { "awesome-context": { "url": "https://awesomecontext.awareness.market/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Replace YOUR_API_KEY with the key from your dashboard. An API key is required to use the cloud service.3. Start codingClaude will automatically call get_rules when you start a new session. Rules are injected based on your project type.Self-HostedFull controlRun the complete stack locally or on your own infrastructure. Customize rules and add your own modules.1. Clone and buildCopygit clone https://github.com/everest-an/AwesomeContext.git cd AwesomeContext docker compose --profile cloud up -d2. Configure Claude CodeCopy{ "mcpServers": { "awesome-context": { "url": "http://localhost:3000/mcp" } } }3. Add custom rules (optional)Drop markdown files into vendor/ and rebuild to add your own engineering rules and skills.Optional: Auto-Invocation with CLAUDE.mdFor the best experience, add a CLAUDE.md file to your project root. This tells Claude to always invoke AwesomeContext tools at the right moments.Copy# CLAUDE.md ## MCP Tools — Auto-Invocation Rules ALWAYS call these tools from the "awesome-context" MCP server: 1. **get_rules** — Call at the START of every conversation with project_type matching this project's stack. 2. **architect_consult** — Call BEFORE writing any code. Pass your design intent as the "intent" parameter. 3. **compliance_verify** — Call BEFORE committing code. Pass the code diff as the "code" parameter.