StackBridge
🌉 StackBridge-MCP
AIコーディングエージェント向けのサブミリ秒クロススタック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 でクロススタックの影響範囲を発見し、ベースライン差分によるコンパイラチェックで、誤検知ゼロで変更を検証します。
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グラフ: Next.js(
fetch、Axios、React Query)↔ FastAPIルート↔ SQLAlchemy ORMモデルを、重いLSPサイドカーやランタイムインポートなしで解析。⚡ サブミリ秒トラバーサル: 永続的なSQLite WALデータベースと再帰的共通テーブル式(0.75 ms のトラバーサルクエリレイテンシ)。
📉 プロンプトトークン99.74%削減: 巨大な複数ファイルのコードダンプを、コンパクトで数学的に正確なAST契約スライスに置き換え。
🛡️ 根本原因診断ランキング: グラフ距離BFSによるエラーのランク付け(
🔴 PRIMARY ROOT CAUSEvs⚠️ CASCADING BREAKAGE)と、即時のGit差分パッチ出力。🧪 テスト影響選択: スキーマ変更の影響を受けるテストスイートを分離し、未テストの影響範囲パス(カバレッジ0%)を強調表示。
🌐 インタラクティブキャンバス: 内蔵のlocalhost三者可視化ツール(
stackbridge ui)をhttp://127.0.0.1:3456で提供。🔄 継続的インテリジェンス: バックグラウンドファイル監視デーモン(
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⚙️ クライアント設定
StackBridgeを標準のJSON-RPC 2.0 stdioで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呼び出し元を信頼度スコア付きで抽出。 |
|
| 影響を受けるファイル全体でインメモリコンパイラチェックを実行し、根本原因をランク付けし、差分パッチを提案。 |
|
| リアルタイムのフルスタック境界統計、ノード数、エッジ数、および破損ドリフト状況を返す。 |
💻 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