StackBridge
🌉 StackBridge-MCP
AI 코딩 에이전트를 위한 Sub-1ms Cross-Stack AST 계약 및 검증 레이어
💡 StackBridge를 사용하는 이유?
AI 코딩 에이전트(Cursor, Claude Code, Windsurf, Antigravity)가 풀스택 코드베이스에서 백엔드 모델이나 API 라우트를 편집할 때, 백엔드 단위 테스트는 자주 통과하지만 프론트엔드는 프로덕션에서 조용히 깨집니다:
에이전트가
backend/routes.py에서 API 매개변수나 Pydantic/SQLAlchemy 필드를 수정합니다.백엔드 테스트는 격리된 상태에서 통과합니다. 에이전트에게 아무런 경고가 없습니다.
해당 엔드포인트를 호출하는 React/Next.js 클라이언트가 경계를 넘어 런타임 오류로 실패합니다.
StackBridge-MCP는 항상 준비된 Model Context Protocol (MCP) 서버로, 풀스택 AST 관계를 파싱하고, 0.75 ms 내에 크로스 스택 블래스트 반경을 발견하며, 베이스라인 차이 컴파일러 검사를 사용하여 변경 사항을 검증하여 거짓 양성(false positive)이 없습니다.
React / Next.js Client FastAPI Routes SQLAlchemy ORM Models
(TypeScript AST) ───► (Python AST) ───► (Schema AST)
UserProfile.tsx get_user_billing() BillingAccountRelated MCP server: Carto MCP Server
⚡ 주요 하이라이트
🌲 Tree-sitter AST 그래프: 무거운 LSP 사이드카나 런타임 임포트 없이 Next.js (
fetch, Axios, React Query) ↔ FastAPI 라우트 ↔ SQLAlchemy ORM 모델을 파싱합니다.⚡ 서브 1ms 순회: 재귀적 공통 테이블 표현식(0.75 ms 순회 쿼리 지연 시간)을 사용하는 영구 SQLite WAL 데이터베이스.
📉 99.74% 프롬프트 토큰 감소: 대규모 다중 파일 코드 덤프를 간결하고 수학적으로 정확한 AST 계약 조각으로 대체합니다.
🛡️ 근본 원인 진단 순위: 그래프 거리 BFS가 오류를 순위화합니다(
🔴 PRIMARY ROOT CAUSEvs⚠️ CASCADING BREAKAGE). 즉각적인 Git diff 패치를 출력합니다.🧪 테스트 영향 선택: 스키마 변경에 영향을 받는 테스트 스위트를 격리하고 테스트되지 않은 블래스트 반경 경로(0% 커버리지)를 강조합니다.
🌐 대화형 캔버스:
http://127.0.0.1:3456에서 내장된 localhost 삼자 시각화 도구(stackbridge ui).🔄 지속적 인텔리전스: 백그라운드 파일 감시 데몬(
stackbridge watch) 및 라이브AGENTS.md컨텍스트 생성기.
📊 실제 벤치마크
fastapi-realworld-example-app (44개 파일, 23개 AST 종속성 노드, 10개 교차 경계 엣지)에서 측정한 경험적 성능:
벤치마크 지표 | 원시 코드베이스 덤프 | StackBridge 컴팩트 슬라이스 | 개선 / 지연 시간 |
컨텍스트 윈도우 크기 |
|
| 📉 99.74% 토큰 감소 |
블래스트 반경 순회 | 전체 저장소 검색: | SQLite 재귀 CTE: | ⚡ 200배 빠른 순회 |
컴파일러 검증 | 글로벌 린터: | 베이스라인 차이 엔진: | 🛡️ 거짓 양성 제로 |
자동화된 테스트 스위트 | — | 56 / 56 테스트 통과 | ✅ 100% 통과 |
전체 벤치마크 방법론은 docs/benchmarks.md 및 REAL_WORLD_BENCHMARK.md를 참조하세요.
🚀 빠른 시작
옵션 1: 제로 설치 실행 (uvx 권장)
uvx stackbridge serve옵션 2: Pip 설치
pip install stackbridge
stackbridge serve⚙️ 클라이언트 설정
표준 JSON-RPC 2.0 stdio를 통해 StackBridge를 AI 페어 프로그래머에 연결하세요:
1. Cursor (.cursor/mcp.json)
{
"mcpServers": {
"stackbridge": {
"command": "uvx",
"args": ["stackbridge", "serve"]
}
}
}2. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"stackbridge": {
"command": "python",
"args": ["-m", "stackbridge.main", "serve", "--transport", "stdio"]
}
}
}🤖 MCP 도구 참조
StackBridge는 코딩 에이전트에 높은 사용성을 가진 도구를 제공합니다:
도구 이름 | 인수 | 설명 |
|
| 풀스택 종속성 체인을 추적합니다: 프론트엔드 컴포넌트 ➔ API 라우트 ➔ 데이터베이스 모델. |
|
| HTTP 메서드, 상태 코드, 응답 모델 및 신뢰도 점수가 포함된 연결된 프론트엔드 fetch 호출자를 추출합니다. |
|
| 영향을 받는 파일에 대해 인메모리 컴파일러 검사를 실행하여 근본 원인을 순위화하고 diff 패치를 제안합니다. |
|
| 실시간 풀스택 경계 통계, 노드 수, 엣지 수 및 손상 드리프트 상태를 반환합니다. |
💻 CLI 참조
# Index a repository and export the dependency graph
stackbridge index --repo-path . --force
# Trace blast radius for a model or route
stackbridge trace --target BillingAccount
# Run pre-commit boundary verification guard
stackbridge guard --fail-on-error
# Launch interactive tripartite web visualizer
stackbridge ui --port 3456
# Start continuous background watcher daemon
stackbridge watch
# Generate living AGENTS.md boundary architecture guide
stackbridge init-agents
# Execute performance and token reduction benchmarks
stackbridge benchmark --runs 3 --output BENCHMARK.md📁 저장소 구조
StackBridge-MCP/
├── .github/
│ ├── workflows/ci.yml # CI pipeline (Python 3.10-3.13 on Ubuntu/Windows/macOS)
│ ├── ISSUE_TEMPLATE/ # Bug report and feature request issue templates
│ └── PULL_REQUEST_TEMPLATE.md # Standard PR checklist
├── docs/
│ ├── architecture.md # Subsystem breakdown and Mermaid diagrams
│ ├── benchmarks.md # Benchmark methodology and raw metrics
│ └── ast_extraction_spec.md # Tree-sitter extractor grammar specifications
├── stackbridge/
│ ├── core/ # Unified StackGraph, SQLite CTE store, watcher, route matcher
│ ├── parsers/ # Tree-sitter parsers (TS fetch, Python routes, SQLAlchemy)
│ ├── verifier/ # Baseline-diffed verifier, root-cause ranker, test impact selector
│ ├── mcp_server/ # FastMCP stdio server and JSON-RPC tools
│ ├── benchmarks/ # Benchmark runner and markdown report generator
│ └── ui/ # Localhost tripartite interactive canvas
├── tests/ # 56 automated test suites (parsers, verifiers, MCP E2E, CTE)
├── AGENTS.md # Living agent architecture guide
├── CHANGELOG.md # Version release notes
├── CONTRIBUTING.md # Contribution and development guidelines
├── LICENSE # MIT License
└── pyproject.toml # Package metadata and tool configurations📄 라이선스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.
Maintenance
Related MCP Servers
- Flicense-qualityAmaintenanceMemtrace is a persistent memory layer for coding agents, built as a bi‑temporal structural knowledge graph over your codebase (AST‑driven symbols and relationships, plus temporal evolution and cross‑service API topology)449
- Alicense-qualityBmaintenanceEnables AI coding tools to query your live codebase for routes, import graph, domain context, and blast radius, eliminating hallucinations about project structure.7572MIT
- Alicense-qualityBmaintenanceEnables AI coding agents to execute formal, stateful workflows with typed contracts, postcondition enforcement, and structured retry logic.1Apache 2.0
- AlicenseAqualityCmaintenanceShared, versioned memory and governance control plane for AI coding agents. Compiler pipeline resolves architectural decision conflicts across Claude Code, Cursor, and custom agent fleets.34MIT
Related MCP Connectors
The team layer for AI coding agents: shared contracts, collision alerts, E2EE sessions.
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZainUlAbideen02/StackBridge-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server