하나의 capabilities.yaml 파일을 35개 이상의 AI 코딩 에이전트 전용 설정 형식으로 작성하며, 로컬 게이트웨이를 통해 업스트림 MCP server를 프록시합니다.
다른 이름 infragate/capa
- 스타
- 747
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 7일
- 라이선스
- MIT
CAPA MCP란?
하나의 capabilities.yaml 파일을 35개 이상의 AI 코딩 에이전트 전용 설정 형식으로 작성하며, 로컬 게이트웨이를 통해 업스트림 MCP server를 프록시합니다.
프로젝트 README에서 생성된 요약
CAPA MCP server 정보
CAPA는 개발자가 다양한 코딩 도구에 걸쳐 AI 에이전트 설정을 관리하는 과정을 단순화합니다. 중앙 패키지 매니저이자 로컬 게이트웨이 역할을 수행하며, 단일 capabilities.yaml 파일을 Cursor, Claude Code, Windsurf, GitHub Copilot을 포함한 35개 이상의 에이전트에 필요한 네이티브 형식으로 변환합니다. 단일 진실 공급원(Single source of truth)을 사용함으로써, 팀은 특정 SHA를 고정하는 capabilities.lock 파일을 통해 모든 협업자가 정확히 동일한 도구, 규칙 및 서브 에이전트를 사용하도록 보장할 수 있습니다.
설정 관리 외에도 stdio, HTTP 또는 SSE를 통해 업스트림 서버를 프록시하는 MCP 게이트웨이 역할을 합니다. 이 구성을 통해 도구를 필요할 때만 지연 로딩(lazy-loading)할 수 있으며, 이를 통해 토큰 사용량을 19%에서 40%까지 줄일 수 있습니다. 개발자는 로컬 Web UI 또는 명령줄을 통해 전체 설정을 관리할 수 있으며, wrap 명령을 사용하여 Codex나 Gemini CLI와 같은 에이전트를 섀도우 워크스페이스에서 실행함으로써 기본 저장소를 깔끔하게 유지할 수 있습니다.
활용 사례
- 1에이전트 설정 동기화단일 설정 파일을 커밋하여 모든 팀원에게 동일한 도구 세트와 규칙을 배포합니다.
- 2토큰 소비 감소전체 카탈로그를 모델에 보내는 대신 필요한 도구만 로드하여 추론 비용을 낮춥니다.
- 3서브 에이전트 권한 격리특정 도구에 대한 접근을 특정 서브 에이전트로 제한하여 의도치 않은 동작을 방지합니다.
- 4저장소 청결도 유지AI 코딩 에이전트를 섀도우 워크스페이스에서 실행하여 프로바이더별 설정 폴더가 프로젝트를 어지럽히지 않도록 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능infragate/capa is public and reachablegithub.com/infragate/capa ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-07github.com/infragate/capa ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Declare skills, tools, rules, sub-agents, MCP servers, hooks, and plugins once in capabilities.yaml. Run capa install. CAPA writes them into Cursor, Claude Code, Codex, Windsurf, GitHub Copilot, and 35+ other agents — native formats, pinned SHAs, zero manual sync. At runtime it is also the MCP gateway: every agent talks to one local endpoint; CAPA proxies upstream servers, lazy-loads tools, and scopes what each sub-agent can call.
https://github.com/user-attachments/assets/200a8cf9-7236-4cc0-a9e4-332bb6664b41
Why CAPA?
Agent config today is scattered across CLAUDE.md, .cursor/rules/, AGENTS.md, MCP JSON, hooks, and skill folders. No two teammates match. Nothing is pinned. Cloning the repo does not clone the agent setup.
CAPA collapses that into one version-controlled file next to your code — and a local MCP gateway in front of every tool:
capabilities.yaml— source of truth for every capabilitycapabilities.lock— SHA pins so tomorrow's clone gets the same bytes- Marker blocks — surgical writes that leave hand-edited content alone
- MCP gateway — one endpoint per project; CAPA proxies stdio / HTTP / SSE servers, applies formatters, and records activity
The teammate who clones tomorrow gets the exact setup you have today.
Features
- One file → 35+ agents — write once; CAPA fans out to each provider's native layout (
.cursor/rules/,.claude/agents/,AGENTS.md, …) - MCP gateway — one local endpoint per agent; CAPA proxies upstream MCP servers, lazy-loads tools on demand, and filters tools per sub-agent
- Cheaper inference, same quality — on-demand tool loading instead of front-loading the whole catalog (19–40% fewer tokens across 150 trials on claude-opus-4-8)
capa wrap— run Cursor, Claude, Codex, and more from a shadow workspace so provider dirs never touch your real repo- Local Web UI — interactive capabilities editor with live YAML sync, registry browse, OAuth setup, and drag-to-reorder
- Activity traces — live feed of every MCP call, shell tool, and agent span on the project page
- Plugins that unpack — Claude and Cursor plugins decompose into skills, MCP, rules, sub-agents, and hooks
- Registries — browse skills.sh, Cursor Marketplace, Claude plugins, and Claude marketplace catalogs
capa add --passthrough— write provider-native files directly when you want unmanaged one-offs- Sub-agent isolation — each sub-agent gets a filtered MCP endpoint, so research agents never inherit a
git pushtool
Installation
macOS and Linux:
curl -LsSf https://capa.sh/install.sh | sh
Windows:
powershell -ExecutionPolicy ByPass -c "irm https://capa.sh/install.ps1 | iex"
Quick start
1. Initialize
cd your-project
capa init
Creates capabilities.yaml and registers the project with the local CAPA server (default http://localhost:5912).
The new file points at the JSON Schema, so editors with YAML/JSON language support autocomplete and validate it. For an existing file, add this first line:
# yaml-language-server: $schema=https://raw.githubusercontent.com/infragate/capa/main/schema/capabilities.schema.json
2. Add capabilities
capa add vercel-labs/agent-skills@web-researcher
capa add --server --id brave --cmd npx --arg @brave/brave-search-mcp
capa registry search skills-sh "research"
3. Install
capa install # interactive: confirms executable surface, then installs
capa install --yes # CI / scripts: skip confirmation
capa install --dry-run # preview MCP servers, hooks, and commands without changes
Resolves SHAs, fills the cache, writes per-provider files, and registers one MCP endpoint with each configured agent. Resolved SHAs land in capabilities.lock.
[!NOTE] Non-interactive shells (CI, scripts) must pass
--yes. The first install prints the executable surface (MCP stdio servers, hooks, command tools, plugins) and asks for confirmation; unchanged surfaces skip the prompt on re-run.
[!TIP] Already have skills, MCP configs, and rules in the repo? After
capa init, use the bundled/bootstrapskill — the agent scans the project and drafts the CAPA config for you.
4. Run tools from the terminal
capa sh # list every configured tool
capa sh brave # list brave subcommands
capa sh brave search --query "…" # run a tool directly
capa sh --raw brave search --query "…" # skip per-tool formatters
Every tool you define is also a CLI command under capa sh.
5. Open the Web UI
capa open # open this folder's project in the browser
capa open ../other # or any other project folder
capa status # prints the local URL when the server is up
Edit skills, tools, rules, hooks, plugins, and agents in the browser. Changes sync live back to capabilities.yaml.
capa wrap
Run an agent without polluting your repo with .cursor/, .claude/, and friends. CAPA builds a shadow workspace under ~/.capa/workspaces/, symlinks your project (minus provider-owned paths), installs capabilities into the shadow, and launches the agent.
capa wrap cursor # Cursor GUI — stops when the window closes
capa wrap claude # Claude Code (aliases: claude-code)
capa wrap agent # Cursor CLI
capa wrap codex
capa wrap gemini-cli
capa wrap opencode
capa wrap cursor --print-dir # print shadow path, then launch
capa wrap --prune # clean stale workspaces
capa stop # stop server + active wrap sessions
Wrappable today: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, iFlow CLI, Kiro CLI, Qwen Code, Kimi CLI.
[!NOTE] On Windows, creating the shadow workspace may require Developer Mode (or an elevated shell) for symlinks. GitHub Copilot is not wrappable yet — it owns shared
.github//.vscode/trees that need subpath exclusions.
Web UI & observability
The embedded React UI (served by the local server) covers the full project lifecycle:
| Area | What you get |
|---|---|
| Capabilities editor | Skills, tools, rules, hooks, sub-agents, plugins, agents — CRUD, local file pickers, drag reorder |
| Registries | Search seeded catalogs (skills.sh, Cursor Marketplace, Claude plugins) and add your own |
| Activity | Live tool-call feed, charts, and run timelines (default-on via options.agentActivity) |
| Variables / OAuth | Credential setup when install needs secrets |
Activity is powered by system hooks and the MCP proxy tracer — MCP failures show as error rows, shell tools from capa sh are labeled correctly, and secrets in args/results are redacted.
Plugins & registries
Plugins are not opaque blobs. CAPA clones the repo, reads Claude (.claude-plugin/) or Cursor (.cursor-plugin/) manifests, and merges skills, MCP servers, rules, sub-agents, and hooks into the same install pipeline as everything else.
capa add owner/repo --plugin --install
capa add cursor-marketplace:some-plugin --plugin
capa registry list
capa registry add anthropics/claude-plugins-official --type claude-marketplace
capa registry search skills-sh "typescript"
[!IMPORTANT] Most registry adapters are executable TypeScript fetched into
~/.capa/registries-managed/. Review the source before enabling a third-party registry. Claude marketplaces are JSON catalogs only — safer by design.
Passthrough mode
Need a one-off native write without CAPA managing the file?
capa add owner/repo@skill --passthrough --provider cursor
capa add --rule --id ts-strict --inline "Always use strict TypeScript" --passthrough
capa install --passthrough
Passthrough skips capabilities.yaml, the lockfile, and managed-file tracking. Tool aliases, defaults, and formatters still require managed mode (capa add --tool … --passthrough is refused).
How it fits together
capabilities.yaml ──► capa install ──► provider files (.cursor/, .claude/, AGENTS.md, …)
│ │
│ ├── capabilities.lock
│ ├── ~/.capa/cache/ (content-addressed snapshots)
│ └── ~/.capa/db.sqlite (projects, variables, activity)
│
└──► Web UI editor ◄──► file watcher ◄──► disk
Agent ──MCP──► capa gateway (:5912) ──proxy──► upstream MCP (stdio / HTTP / SSE)
│
├── on-demand tools (setup_tools / call_tool)
├── per-sub-agent filtered endpoints
└── ToolCallTracer → activity feed
CLI cheat sheet
capa init # create capabilities.yaml + register project
capa add <source> [--plugin] [--install]
capa add --server|--tool|--rule|--hook …
capa install [-p <provider>] [-e .env] [--no-cache] [--yes] [--dry-run]
capa wrap <provider> [--project <path>]
capa sh [tool] [args…] [--raw]
capa registry search|add|list|refresh|remove …
capa start|stop|restart|status
capa clean # remove managed artifacts
capa auth github|gitlab
capa cache | capa cache clean
capa upgrade [--yes] # pin GitHub release + verify installer checksum
Documentation
Guides, the full schema reference, and the registry catalog:
Maintainer-oriented internals (install pipeline, provider matrix, lockfile semantics) live in docs/.
Community
- @InfragateAI: release notes, new providers, and CAPA tips
- @AntonioZaitoun: built by Antonio Zaitoun; follow along for what's next
Questions or bugs? Open an issue.
CAPA MCP 질문
CAPA가 AI 코딩 에이전트에 어떤 역할을 하나요?
단일 capabilities.yaml 파일을 읽어 각 에이전트의 네이티브 레이아웃에 맞춰 SKILL, 도구, 규칙, 서브 에이전트, MCP server 및 플러그인을 작성합니다. 또한 업스트림 서버 앞단에서 로컬 MCP 게이트웨이를 실행합니다.
CAPA는 어떤 AI 코딩 에이전트를 지원하나요?
Cursor, Claude Code, Codex, Windsurf, GitHub Copilot을 포함하여 35개 이상의 다른 에이전트를 지원합니다. capa wrap을 사용하면 Claude Code, Codex, Cursor, Gemini CLI, OpenCode 등을 섀도우 워크스페이스에서 실행할 수도 있습니다.
CAPA를 어떻게 설치하나요?
macOS 및 Linux에서는 curl 설치 스크립트를 사용하고, Windows에서는 PowerShell 한 줄 명령어를 사용합니다. 설치 후 프로젝트에서 capa init을 실행하여 capabilities.yaml을 생성합니다.
CAPA를 사용하면 토큰 사용량이 줄어드나요?
네. MCP 게이트웨이가 전체 카탈로그를 미리 로드하는 대신 도구를 필요할 때만 로드하므로, README에 따르면 150회 테스트 결과 토큰 사용량을 19~40% 절감할 수 있습니다.
터미널에서 설정된 도구를 어떻게 실행하나요?
정의한 모든 도구는 capa sh 아래의 CLI 명령어가 됩니다. capa sh로 도구 목록을 확인한 후, capa sh brave search --query "…"와 같이 서브 명령어를 실행하면 됩니다.