Ecc
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
What is Ecc?
Ecc is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent harness performance optimization system. skills, instincts, memory, security, and research-first development for claude code, codex, opencode, cursor and beyond.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The agent harness performance optimization system. Skills, i
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx eccConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Ecc
ECC (Enhanced Claude Code) is a harness-native performance system for AI coding agents that ships 261 skills, session adapters, memory optimization hooks, security scanning, and cross-harness configuration for Claude Code, Codex, Cursor, OpenCode, Gemini CLI, and Zed. It is not a single MCP server but an operator-level system — production-ready agents, skills, hooks, MCP configurations, and legacy command shims evolved over 10+ months of intensive daily use building real products. Teams adopt it to dramatically cut token consumption, persist memory across sessions, parallelize work across git worktrees, and run continuous quality gates without manual setup.
Prerequisites
- Node.js 18 or higher installed (for npx-based install)
- An AI coding agent harness — Claude Code, Cursor, Codex CLI, OpenCode, or Gemini CLI
- Git installed for worktree and session features
- Optional: Python 3.10+ if using Python-specific skills or hooks
Run the ECC installer
The quickest way to get started is the npx one-liner, which launches an interactive setup that detects your harness and installs the appropriate skill set, hooks, and MCP config.
npx eccRead the Shorthand Guide first
ECC ships two guides in-tree. Read the-shortform-guide.md before anything else — it covers setup philosophy, token optimization, and which components to install for your use case.
Configure hook profiles
ECC hooks are controlled by two environment variables. Set ECC_HOOK_PROFILE to minimal, standard, or strict to gate how aggressively hooks run. Disable individual hooks by name if needed.
# In your shell profile or .env:
export ECC_HOOK_PROFILE=standard
# To disable specific hooks:
export ECC_DISABLED_HOOKS=observer,session-summaryAdd the MCP server config to your client
ECC exposes an MCP server surface for tool discovery and operator status. Add it to your Claude Desktop or .mcp.json config. The exact command depends on your install path.
{
"mcpServers": {
"ecc": {
"command": "npx",
"args": ["ecc"]
}
}
}Run harness audit to verify setup
Once installed, run the built-in harness audit command to get a scored health report of your ECC configuration, hook status, and skill inventory.
/harness-auditEcc Examples
Client configuration
Minimal Claude Desktop config to launch ECC via npx.
{
"mcpServers": {
"ecc": {
"command": "npx",
"args": ["ecc"],
"env": {
"ECC_HOOK_PROFILE": "standard"
}
}
}
}Prompts to try
Skill and operator commands you can use once ECC is active in your coding agent.
- "Run /harness-audit and show me what's failing"
- "Use the typescript-reviewer skill to review my PR diff"
- "Start a parallel worktree session for the feature/auth branch"
- "What skills do I have installed? List them with /skill-stocktake"
- "Optimize my session for minimal token usage using ECC_HOOK_PROFILE=minimal"Troubleshooting Ecc
npx ecc fails with 'command not found' or installs the wrong package
The npm package name is ecc-universal. If bare 'npx ecc' resolves a different package, run 'npx ecc-universal' instead, or install globally with 'npm install -g ecc-universal'.
Hooks cause a memory explosion or the observer loop never exits
Set ECC_HOOK_PROFILE=minimal to disable heavy hooks, or add the specific offending hook name to ECC_DISABLED_HOOKS. ECC v1.9.0+ includes re-entrancy guards and tail sampling, but very large repos can still hit limits with strict profiles.
Skills are listed but do not load in the agent context
Skills use lazy-load: only the name and description (~100 tokens) load at session start; the full SKILL.md body loads on demand. If a skill body never loads, check that the skills directory path is correctly resolved by running 'ecc status' to see the install state store.
Frequently Asked Questions about Ecc
What is Ecc?
Ecc is a Model Context Protocol (MCP) server that agent harness performance optimization system. skills, instincts, memory, security, and research-first development for claude code, codex, opencode, cursor and beyond. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Ecc?
Follow the installation instructions on the Ecc GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Ecc?
Ecc works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Ecc free to use?
Yes, Ecc is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Ecc Alternatives — Similar Developer Tools Servers
Looking for alternatives to Ecc? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
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
Awesome Claude Skills
★ 61.1kA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
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 Ecc 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 Ecc?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.