Bridge Suite MCP

桥接套件MCP服务器

](https://www.npmjs.com/package/@llitd/bridge-suite-mcp)   

让AI代理完全访问您的IntelliJ IDE。

Bridge Suite是一个免费的开源软件 主控程序 该服务器通过四个专用插件将AI编码助手连接到IntelliJ IDEA。在终端中运行命令、触发构建、将通知推送到IDE中以及查询项目上下文——所有这些都是通过单个MCP服务器完成的。

适用于 克劳德代码, 克劳德桌面, 光标, 帆板运动, 克莱恩, 继续，以及任何兼容MCP的客户端。

______________________________________________________________________

为什么选择Bridge Suite？

JetBrains的内置MCP服务器处理文件操作和基本代码检查，但它没有揭示IntelliJ在人工智能工作流中的强大之处：

桥接套件和内置MCP 互补的 --安装两者以实现完整的IDE控制。

______________________________________________________________________

快速开始

1.安装MCP服务器

添加到MCP客户端配置中：

克劳德代码 (.mcp.json):

{
  "mcpServers": {
    "bridge-suite": {
      "command": "npx",
      "args": ["-y", "@llitd/bridge-suite-mcp"]
    }
  }
}

克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "bridge-suite": {
      "command": "npx",
      "args": ["-y", "@llitd/bridge-suite-mcp"]
    }
  }
}

光标 （设置>MCP服务器）：

Name: bridge-suite
Command: npx -y @llitd/bridge-suite-mcp

2.安装至少一个插件

MCP服务器连接到IntelliJ中运行的插件。从安装它们 JetBrains市场:

每个插件在本地主机上运行一个轻量级HTTP服务器。MCP服务器会自动发现正在运行的插件。

3.验证

问你的AI助手：

“检查哪些Bridge Suite插件可用”

它会召唤 bridge_status 并向您展示正在运行的内容。

______________________________________________________________________

工具

bridge_status

检查哪些插件已安装、正在运行和获得许可。 先叫这个 看看有什么可用的。

bridge_status()

退货：

{
  "terminal-bridge": {
    "name": "Terminal Bridge",
    "running": true,
    "version": "2.4.2",
    "licensed": true
  },
  "notification-bridge": {
    "name": "Notification Bridge",
    "running": true,
    "version": "1.0.0",
    "licensed": false
  },
  ...
}

______________________________________________________________________

terminal --航站桥

管理IntelliJ终端选项卡。创建终端，发送命令，读取输出。

示例：

// List terminals
terminal({ action: "list" })

// Run a command
terminal({ action: "send", id: "terminal-1", command: "npm test" })

// Read output
terminal({ action: "read", id: "terminal-1", max_lines: 50 })

______________________________________________________________________

run_config --运行配置桥

执行IntelliJ运行/调试配置。启动构建、运行测试、启动服务器——项目中定义的任何运行配置。

示例：

// List all run configurations
run_config({ action: "list" })

// Run "Backend Server" configuration
run_config({ action: "run", id: "backend-server" })

// Check process output
run_config({ action: "output", id: "process-1", max_lines: 100 })

______________________________________________________________________

notify --通知桥

将通知、进度条和状态栏小部件直接推送到IDE中。非常适合长时间运行的AI任务、CI/CD结果或监控警报。

示例：

// Send a notification
notify({ action: "send", title: "Build Complete", content: "All 42 tests pass", type: "INFORMATION" })

// Warning notification
notify({ action: "send", title: "Memory High", content: "Heap usage at 89%", type: "WARNING" })

// Create a progress bar (Pro)
notify({ action: "progress_create", title: "Deploying to Production", fraction: 0.0 })

// Update progress
notify({ action: "progress_update", id: "abc123", text: "Stage 2/3", fraction: 0.66 })

// Complete it
notify({ action: "progress_complete", id: "abc123" })

// Notification with action buttons (Pro)
notify({
  action: "action",
  title: "PR #42 Ready",
  content: "All checks pass. Merge?",
  type: "INFORMATION",
  actions: [
    { label: "Open PR", id: "open", url: "https://github.com/org/repo/pull/42" },
    { label: "Merge", id: "merge" }
  ]
})

// Status bar widget (Pro)
notify({ action: "statusbar_create", id: "api-health", text: "API: 200ms", tooltip: "Average response time" })

______________________________________________________________________

project_intel --项目智能桥

获取丰富的项目上下文——SDK版本、检测到的框架、依赖树、文件结构。对于需要在做出更改之前了解项目的AI代理很有用。

示例：

// Get full project context
project_intel({ action: "context" })

// Quick summary for LLM context windows
project_intel({ action: "summary" })

// Check frameworks
project_intel({ action: "frameworks" })

______________________________________________________________________

建筑

┌──────────────────────────────────┐
│   AI Assistant (Claude, Cursor)  │
│   Uses MCP tools to control IDE  │
└──────────────┬───────────────────┘
               │ MCP Protocol (stdio)
┌──────────────▼───────────────────┐
│   Bridge Suite MCP Server        │
│   Free, open-source (this repo)  │
│   Auto-discovers running plugins │
└──────────────┬───────────────────┘
               │ HTTP (localhost)
   ┌───────────┼───────────┬───────────────┐
   ▼           ▼           ▼               ▼
┌──────┐  ┌──────┐   ┌──────────┐   ┌──────────┐
│:9876 │  │:9877 │   │  :9878   │   │  :9885   │
│Term  │  │ Run  │   │  Notif   │   │  Project │
│Bridge│  │Config│   │  Bridge  │   │  Intel   │
└──┬───┘  └──┬───┘   └────┬─────┘   └────┬─────┘
   │         │            │              │
   └─────────┴────────────┴──────────────┘
                    │
          IntelliJ IDEA (IDE APIs)

每个插件在本地主机上运行一个嵌入式HTTP服务器。MCP服务器探测端口以发现哪些插件可用。如果插件未安装，其工具会返回一条带有安装链接的有用消息。

安全： 一切都在本地主机上运行。没有数据离开你的机器。仅本地访问不需要身份验证。

______________________________________________________________________

插件可用性

当一个工具针对一个没有运行的插件时，你会得到一个明确的信息：

{
  "success": false,
  "error": "Notification Bridge is not running. Install it from JetBrains Marketplace: https://plugins.jetbrains.com/plugin/30984-notification-bridge — then restart IntelliJ IDEA.",
  "code": "PLUGIN_NOT_AVAILABLE"
}

当工具需要免费层上的付费功能时：

{
  "success": false,
  "error": "This feature requires a paid Notification Bridge license. Upgrade at: https://plugins.jetbrains.com/plugin/30984-notification-bridge",
  "code": "LICENSE_REQUIRED"
}

______________________________________________________________________

配置

自定义端口

如果你的插件在非标准端口上运行，请设置环境变量：

TERMINAL_BRIDGE_PORT=9876       # default
RUN_CONFIG_BRIDGE_PORT=9877     # default
NOTIFICATION_BRIDGE_PORT=9878   # default
PROJECT_INTELLIGENCE_PORT=9885  # default

插件设置

每个插件在IntelliJ中都有自己的设置： 设置>工具>\[插件名称\]

所有插件的通用设置：

• 港口 --HTTP服务器端口
• 自动启动 --IDE打开时启动服务器
• CORS起源 --跨来源请求的允许来源

______________________________________________________________________

用例

人工智能驱动的开发工作流程

1. project_intel({ action: "context" })     → Understand the project
2. terminal({ action: "send", ... })        → Run commands
3. run_config({ action: "run", ... })       → Build/test
4. run_config({ action: "output", ... })    → Check results
5. notify({ action: "send", ... })          → Report completion

CI/CD通知管道

1. notify({ action: "channel_create", id: "ci", name: "CI Pipeline" })
2. notify({ action: "progress_create", title: "Deploying v2.1" })
3. notify({ action: "progress_update", id: "...", fraction: 0.5 })
4. notify({ action: "progress_complete", id: "..." })
5. notify({ action: "action", title: "Deploy Complete", actions: [...] })

多终端编排

1. terminal({ action: "create", name: "backend" })
2. terminal({ action: "create", name: "frontend" })
3. terminal({ action: "send", id: "backend", command: "mvn spring-boot:run" })
4. terminal({ action: "send", id: "frontend", command: "npm run dev" })
5. terminal({ action: "read", id: "backend" })  → Check startup

______________________________________________________________________

需求

• 智能J IDEA 2025.3+（终极或社区）
• Node.js 18+（适用于MCP服务器）
• 至少安装了一个Bridge Suite插件

______________________________________________________________________

定价

MCP服务器是 免费和开源 （MIT许可证）。

每个插件都使用一个 免费增值模式 JetBrains市场：

自由层包括基本的读取/执行操作。专业版解锁了创建、流媒体和高级功能。有关层的详细信息，请参阅上面的工具表。

JetBrains社区项目（学生、开源、初创公司）提供免费许可证。

______________________________________________________________________

发展

git clone https://github.com/llitd/bridge-suite-mcp.git
cd bridge-suite-mcp
npm install
npm run build

在本地运行：

node dist/index.js

项目结构

src/
  index.ts              Entry point (stdio transport)
  discovery.ts          Plugin auto-discovery (port probing)
  http-client.ts        Shared HTTP client with error handling
  tools/
    bridge-status.ts    Meta tool: plugin discovery
    terminal.ts         Terminal Bridge proxy
    run-config.ts       Run Configuration Bridge proxy
    notify.ts           Notification Bridge proxy
    project.ts          Project Intelligence Bridge proxy
    registry.ts         Tool registration

______________________________________________________________________

链接

• JetBrains市场上的LLITD
• 终端桥
• 运行配置桥
• 通知桥
• 项目智能桥
• 模型上下文协议
• 报告问题

______________________________________________________________________

许可证

麻省理工学院——见 许可证