StackBridge
🌉 StackBridge-MCP
Субмиллисекундный слой контрактов и верификации AST для AI-агентов кодирования
💡 Зачем нужен StackBridge?
Когда AI-агенты кодирования (Cursor, Claude Code, Windsurf, Antigravity) редактируют бэкенд-модели или API-маршруты в full-stack кодовых базах, юнит-тесты бэкенда часто проходят, в то время как фронтенд молча ломается в продакшене:
Агент изменяет параметр API или поле Pydantic/SQLAlchemy в
backend/routes.py.Бэкенд-тесты проходят изолированно. Ничто не предупреждает агента.
React/Next.js клиент, вызывающий эту конечную точку через границу, падает с ошибками времени выполнения.
StackBridge-MCP — это постоянно активный сервер Model Context Protocol (MCP), который анализирует full-stack AST-отношения, обнаруживает радиус поражения между стеками за 0.75 мс и проверяет изменения с помощью компиляторных проверок на основе базового диффа с нулевым количеством ложных срабатываний.
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-сайдкаров или импортов времени выполнения.⚡ Обход менее чем за 1 мс: Постоянная база данных SQLite WAL с рекурсивными общими табличными выражениями (0.75 мс задержка запроса обхода).
📉 Сокращение токенов промпта на 99.74%: Заменяет массивные дампы кода из нескольких файлов компактными, математически точными срезами AST-контрактов.
🛡️ Ранжирование диагностики первопричин: BFS на основе расстояния в графе ранжирует ошибки (
🔴 ПЕРВИЧНАЯ ПРИЧИНАvs⚠️ КАСКАДНАЯ ПОЛОМКА) и выводит немедленные 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% |
Обход радиуса поражения | Полнорепозиторный поиск: | Рекурсивный CTE SQLite: | ⚡ Ускорение в 200 раз |
Верификация компилятором | Глобальный линтер: | Движок на базовом диффе: | 🛡️ Ноль ложных срабатываний |
Автоматизированный набор тестов | — | 56 / 56 тестов проходят | ✅ 100% прохождение |
Полную методологию бенчмарков см. в docs/benchmarks.md и REAL_WORLD_BENCHMARK.md.
🚀 Быстрый старт
Вариант 1: Выполнение без установки (рекомендуется через uvx)
uvx stackbridge serveВариант 2: Установка через pip
pip install stackbridge
stackbridge serve⚙️ Конфигурация клиента
Подключите StackBridge к вашему AI-программисту через стандартный JSON-RPC 2.0 stdio:
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 предоставляет агентам кодирования высокоэргономичные инструменты:
Имя инструмента | Аргументы | Описание |
|
| Прослеживает full-stack цепочку зависимостей: компонент фронтенда ➔ API-маршрут ➔ модель базы данных. |
|
| Извлекает HTTP-методы, коды состояния, модели ответов и связанные вызовы fetch на фронтенде с оценкой уверенности. |
|
| Запускает компиляторные проверки в памяти по затронутым файлам, ранжируя первопричины и предлагая дифф-патчи. |
|
| Возвращает статистику границ full-stack в реальном времени: количество узлов, рёбер и статус дрейфа поломок. |
💻 Справочник 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