mcpField
I
IAF Agent Bridge

IAF Agent Bridge

本地服务
github.comAI 与智能体04 周前更新
代码仓库访问官网

关于 IAF Agent Bridge

IAF Agent Bridge 是面向使用 Codex、Claude Code 或其他 stdio 主机的 MCP 服务，可将实现任务交给 Cursor Agent。它返回会话 ID，以便在同一 Cursor 会话中继续工作；后续由监督方决定继续、完成或阻塞。

主要功能

  1. 01将任务委派给 Cursor Agent
  2. 02通过 sessionId 恢复会话
  3. 03取消正在执行的轮次
  4. 04检查环境与身份验证
  5. 05默认限制破坏性操作

适用场景

  1. 01从 Codex 委派代码修改
  2. 02跨多个轮次继续 Cursor 任务
  3. 03停止正在执行的 Cursor 轮次
  4. 04检查本地 Cursor CLI 环境

MCP 相关

通过 stdio 向 MCP 主机提供 `delegate`、`cancel` 和 `doctor` 工具。它通过 ACP 与本地 Cursor CLI 通信，并为后续调用返回会话 ID。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "francescoveryra-dot-iaf-agent-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "iaf-agent-bridge"
      ]
    }
  }
}
启动命令npx -y iaf-agent-bridge

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmiaf-agent-bridge1.1.0

工具

3

收录的工具列表 · 更新于 3 周前

参数类型必填说明
fastboolean否请求使用 Cursor 的快速档位。除非用户提出要求，否则保持为 false。费用更高。
modeenum否agent 表示由 Cursor 实施。plan 表示要求 Cursor 制定计划并停止。ask 用于偏向阅读理解的问题。该模式是向 Cursor 发出的指令。agent | plan | ask
modelstring否可选的 Cursor 模型 ID。省略则沿用 Cursor 当前默认模型。
effortstring否所选模型公布的精确 effort 值。无效值会在发送提示词前导致失败，并列出可接受的值。
promptstring是适用于 Cursor 的自然语言提示词。按原文发送。请引用文件和项目文档，而不要粘贴其内容。
contextstring否当模型提供上下文窗口选项时使用，例如 272k 或 1m。除非用户要求，否则省略。
sessionIdstring否恢复此 Cursor 会话。省略则启动新会话。后续工作使用上次结果中的 sessionId。
workspacestring是Cursor 将在其中工作的现有项目目录。不能是主目录或文件系统根目录。
contextFilesarray否要附加的文件。文本将作为资源链接传递。Cursor 接受图片时，图片（png、jpg、gif、webp，且小于 5MB）会以内联方式发送。缺失文件会发出警告，但不会导致失败。

详细介绍

IAF Agent Bridge

MCP 服务，让 Codex、Claude Code 或其他 stdio 宿主能够将任务交给 Cursor Agent，并在同一个 Cursor 会话中持续处理，直到完成请求的工作。

该桥接服务传递提示词、会话和 Cursor 的回复。由监督方决定接下来要做什么，Cursor 负责实现。

delegate 只有在 Cursor 本轮处理结束后才会返回。即使消息表示工作已完成，只要 Cursor 仍在运行工具、子 Agent 或后续任务，调用就不会结束。这些内部工作仍由 Cursor 控制。监督方会收到一个结果，然后选择 CONTINUE、COMPLETE 或 BLOCKED。

状态： npm [email protected] 是当前公开发布的包。GitHub Release v1.1.0 与之对应。v1.0.2、v1.0.1 和 v1.0.0 仍已发布。官方 MCP Registry 条目为 io.github.francescoveryra-dot/iaf-agent-bridge，版本为 1.1.0。

CI npm GitHub Release License: MIT Node

Supervisor (Codex, Claude Code, or another MCP host)
        |
        | MCP over stdio
        v
IAF Agent Bridge
        |
        | ACP over stdio
        v
Cursor Agent
        |
        v
Your repository

Cursor Agent 是唯一的生产执行器。Codex 和 Claude Code 是监督方。不要将此服务安装到 Cursor 正在编辑的仓库所用的 Cursor MCP 配置中。该循环会被拒绝。

你可以做什么

  • 从 MCP 宿主启动 Cursor 会话，并使用 sessionId 恢复会话。
  • 让常规开发工作持续进行，而无需批准每次工具调用。
  • 拒绝强制推送、重写历史、破坏性 SQL、删除项目外的文件以及暂存密钥，除非你明确设置 IAF_PERMISSION_MODE=allow-all。
  • 在仓库有 Master Prompt 时使用它。没有 Master Prompt 的仓库也能正常工作。

前提条件

  • Node.js 20 或更高版本。运行测试套件需要 Node.js 22。
  • 在 PATH 中安装 Cursor CLI，命令名为 agent。
  • 已在该机器上完成 agent login。

本地 stdio 服务无需 OpenAI API 密钥。

Personal Private 模式独立于本地 stdio 服务。你需要创建自己的 Secure MCP Tunnel 和受限运行时密钥。npx iaf-agent-bridge setup chatgpt --project my-project=/absolute/path 会在本地保存该别名，而 npx iaf-agent-bridge chatgpt 会在只有你的用户才能打开的套接字上监听。IAF 不托管中继服务。从常规 ChatGPT 调用 delegate，要求该工作区提供 Full MCP 写入工具。经测试的 ChatGPT Plus 账户不具备此功能。桥接服务不会检测订阅计划。详情：docs/remote-chat.md。

安装

渠道状态方式
npm可用npx -y [email protected]
官方 MCP Registry可用io.github.francescoveryra-dot/iaf-agent-bridge 1.1.0
Cursor 插件可直接安装agent plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git
Cursor Marketplace已提交——等待审核暂不可公开安装。仍可通过 agent plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git 直接安装。
Claude Code可直接安装claude plugin marketplace add francescoveryra-dot/IAF-Agent-Bridge then claude plugin install iaf-agent-bridge@iaf-agent-bridge
GitHub Copilot CLI可直接安装copilot plugin marketplace add francescoveryra-dot/IAF-Agent-Bridge then copilot plugin install iaf-agent-bridge@iaf-agent-bridge
Codex / ChatGPT GitHub 插件可直接安装codex plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git --ref main then codex plugin add iaf-agent-bridge@iaf-agent-bridge
OpenAI 插件目录不适用于此本地服务公开目录审核的是托管的 HTTPS MCP 端点。此桥接程序在你的计算机上运行，并与本地 Cursor CLI 通信。
VS Code MCP gallery未列出VS Code 浏览 GitHub MCP 注册表。此服务已列入官方 MCP Registry，但未列入该目录。使用 npx -y iaf-agent-bridge 添加。

手动配置 MCP 仍是备用方案。请参阅 docs/installation.md 和 docs/hosts.md。

快速开始

git clone https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git
cd IAF-Agent-Bridge
npm install
npm run build
node dist/cli.js doctor

doctor 应显示 Cursor 可执行文件和 Authenticated: true。它不会打印你的账户信息。

将 MCP 宿主指向已发布的软件包：

command: npx
args:    ["-y", "[email protected]"]

检出源代码后，可在运行 npm run build 后使用 node 和 dist/cli.js。然后请监督者使用 Cursor 实现工作，并在仍有待完成的工作时，使用返回的 sessionId 再次调用 delegate。

按宿主安装

宿主方式详情
Codex使用此仓库中的插件清单，或使用 config.tomldocs/hosts.md
Claude Code使用 claude mcp add 或 .claude-plugin/ 中的插件docs/hosts.md
Cursor用于提交至 marketplace 的插件清单。请勿用它从 Cursor 委派给 Cursor。docs/marketplaces.md
任何 stdio MCP 客户端node + dist/cli.jsdocs/installation.md

通过 npm 安装（npx -y iaf-agent-bridge）会安装 1.1.0。请参阅 docs/installation.md 和 docs/release.md。

工具

工具用途
delegate发送提示词。传入 sessionId 可继续同一段 Cursor 对话。
cancel停止正在进行的轮次。会话仍可恢复。
doctor检查 Node、桥接程序、Cursor CLI 和身份验证状态。

后续调用示例：第一次调用 delegate 会返回 "sessionId": "..."。下一次调用时使用该 ID，并提供说明仍缺少哪些内容的提示词。

监督器应如何运行

像是将 Cursor 的回复粘贴到对话中一样阅读 result。然后选择一种状态：

  • CONTINUE：仍有请求的工作待完成，且 Cursor 仍能完成。这是通常的结果。计划、TODO、模拟内容和缺失的层都属于 CONTINUE。
  • COMPLETE：请求的工作确实已经完成。
  • BLOCKED：仅当需要外部决策、机密或不可逆的授权时使用。

桥接程序不会要求每轮都重新运行 lint、端到端测试套件或覆盖率检查。详情请参阅：docs/supervisor-loop.md。

如果仓库中包含 MASTER_PROMPT.md 或 docs/supervisor-loop.md 中列出的其他项目文件，首个结果会列出这些文件。如果没有，则不会创建任何文件。

配置与故障排除

环境变量：docs/configuration.md。

如果 doctor 提示未找到 Cursor，请安装 CLI 并打开新的 shell。如果提示未通过身份验证，请运行 agent login。更多情况请参阅：docs/troubleshooting.md。

安全

桥接程序可以要求 Cursor 编辑你指定的工作区并在其中运行命令。请阅读 SECURITY.md 和 docs/security-model.md。

请通过私密方式报告漏洞：安全公告。请勿创建包含令牌、凭据或可用漏洞利用代码的公开议题。

贡献

CONTRIBUTING.md。欢迎提交议题和拉取请求。支持渠道见 SUPPORT.md。

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。