Skip to main content
Glama

🌉 StackBridge-MCP

AI 코딩 에이전트를 위한 Sub-1ms Cross-Stack AST 계약 및 검증 레이어

PyPI version Python 3.10+ License: MIT CI Tests FastMCP Compatible


💡 StackBridge를 사용하는 이유?

AI 코딩 에이전트(Cursor, Claude Code, Windsurf, Antigravity)가 풀스택 코드베이스에서 백엔드 모델이나 API 라우트를 편집할 때, 백엔드 단위 테스트는 자주 통과하지만 프론트엔드는 프로덕션에서 조용히 깨집니다:

  1. 에이전트가 backend/routes.py에서 API 매개변수나 Pydantic/SQLAlchemy 필드를 수정합니다.

  2. 백엔드 테스트는 격리된 상태에서 통과합니다. 에이전트에게 아무런 경고가 없습니다.

  3. 해당 엔드포인트를 호출하는 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()              BillingAccount

Related 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 CAUSE vs ⚠️ 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 컴팩트 슬라이스

개선 / 지연 시간

컨텍스트 윈도우 크기

19,705 토큰

51 토큰

📉 99.74% 토큰 감소

블래스트 반경 순회

전체 저장소 검색: ~150 ms

SQLite 재귀 CTE: 0.75 ms

200배 빠른 순회

컴파일러 검증

글로벌 린터: ~3,500 ms

베이스라인 차이 엔진: 312 ms

🛡️ 거짓 양성 제로

자동화된 테스트 스위트

56 / 56 테스트 통과

100% 통과

전체 벤치마크 방법론은 docs/benchmarks.mdREAL_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는 코딩 에이전트에 높은 사용성을 가진 도구를 제공합니다:

도구 이름

인수

설명

trace_fullstack_path

symbol_or_path: str

풀스택 종속성 체인을 추적합니다: 프론트엔드 컴포넌트 ➔ API 라우트 ➔ 데이터베이스 모델.

get_route_contract

route_path: str

HTTP 메서드, 상태 코드, 응답 모델 및 신뢰도 점수가 포함된 연결된 프론트엔드 fetch 호출자를 추출합니다.

verify_schema_change

modified_files: dict

영향을 받는 파일에 대해 인메모리 컴파일러 검사를 실행하여 근본 원인을 순위화하고 diff 패치를 제안합니다.

get_stack_health

repo_path: str

실시간 풀스택 경계 통계, 노드 수, 엣지 수 및 손상 드리프트 상태를 반환합니다.


💻 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 라이선스에 따라 라이선스가 부여됩니다.

Install Server
A
license - permissive license
B
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Related MCP Servers

  • F
    license
    -
    quality
    A
    maintenance
    Memtrace 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
  • A
    license
    A
    quality
    C
    maintenance
    Shared, versioned memory and governance control plane for AI coding agents. Compiler pipeline resolves architectural decision conflicts across Claude Code, Cursor, and custom agent fleets.
    3
    4
    MIT

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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