Skip to main content
Glama

🌉 StackBridge-MCP

AIコーディングエージェント向けのサブミリ秒クロススタック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 でクロススタックの影響範囲を発見し、ベースライン差分によるコンパイラチェックで、誤検知ゼロで変更を検証します。

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グラフ: Next.js(fetch、Axios、React Query)↔ FastAPIルート↔ SQLAlchemy ORMモデルを、重いLSPサイドカーやランタイムインポートなしで解析。

  • ⚡ サブミリ秒トラバーサル: 永続的なSQLite WALデータベースと再帰的共通テーブル式(0.75 ms のトラバーサルクエリレイテンシ)。

  • 📉 プロンプトトークン99.74%削減: 巨大な複数ファイルのコードダンプを、コンパクトで数学的に正確なAST契約スライスに置き換え。

  • 🛡️ 根本原因診断ランキング: グラフ距離BFSによるエラーのランク付け(🔴 PRIMARY ROOT CAUSE vs ⚠️ 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コンパクトスライス

改善 / レイテンシ

コンテキストウィンドウサイズ

19,705 トークン

51 トークン

📉 トークン99.74%削減

影響範囲トラバーサル

全リポジトリ検索: ~150 ms

SQLite再帰CTE: 0.75 ms

200倍高速なトラバーサル

コンパイラ検証

グローバルリンター: ~3,500 ms

ベースライン差分エンジン: 312 ms

🛡️ 誤検知ゼロ

自動テストスイート

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はコーディングエージェントに高エルゴノミクスのツールを提供:

ツール名

引数

説明

trace_fullstack_path

symbol_or_path: str

フルスタックの依存関係チェーンをトレース:フロントエンドコンポーネント ➔ APIルート ➔ データベースモデル。

get_route_contract

route_path: str

HTTPメソッド、ステータスコード、レスポンスモデル、および関連するフロントエンドfetch呼び出し元を信頼度スコア付きで抽出。

verify_schema_change

modified_files: dict

影響を受けるファイル全体でインメモリコンパイラチェックを実行し、根本原因をランク付けし、差分パッチを提案。

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