Offline Protocol

Offline Protocol Agent 插件

用于将编码 Agent（Claude Code、Codex、Cursor、Gemini CLI、VS Code、Cline、Devin 和其他 MCP 客户端）连接到 Offline Protocol 开发工具的插件、技能和 MCP 配置。你的 Agent 可以查找 Offline Protocol SDK 包、阅读集成指南和工作流、规划实现方案，并在你的计算机上搭建或集成项目。

每种配置都会运行已发布的 Offline Protocol CLI 中的本地 MCP 服务 npx -y @offline-protocol/[email protected] mcp serve，或连接到托管的 MCP 服务 https://mcp.offlineprotocol.com/mcp。这些工具可帮助你构建应用程序，但不会发现附近的设备、运行网状网络或控制实时硬件。

• 文档：https://www.offlineprotocol.com/docs/tools/overview
• npm 包：https://www.npmjs.com/package/@offline-protocol/cli

此仓库由 Offline Protocol CLI 源代码中的 export-agent-plugins.mjs 脚本生成。SOURCE.json 记录源提交以及每个文件的 sha256。修改在源代码中进行，然后导出到此处；针对此仓库的拉取请求会经过审核并在上游应用。

要求

Node.js 18 或更高版本，且需安装 npx。首次运行时会从 npm 下载固定版本的 CLI（@offline-protocol/[email protected]）。本地工具无需 Offline Protocol 账户，也不会发送遥测数据。托管服务需要应用 API 密钥及其应用 ID，可从 https://dev.offlineprotocol.com 获取。

安装

Claude Code 插件

claude plugin marketplace add https://github.com/Offline-Protocol/offline-protocol-agent-plugins.git
claude plugin install offline-protocol@offline-protocol

Codex

codex plugin marketplace add https://github.com/Offline-Protocol/offline-protocol-agent-plugins.git
codex plugin add offline-protocol@offline-protocol

或者只添加 MCP 服务：

codex mcp add offline-protocol -- npx -y @offline-protocol/[email protected] mcp serve

Cursor

将 plugins/offline-protocol 复制到 ~/.cursor/plugins/local/offline-protocol，然后重新加载 Cursor。若只需 MCP 服务，请将 distribution/clients/mcp-stdio.json 的内容放入 .cursor/mcp.json 或 ~/.cursor/mcp.json，也可以使用 distribution/clients/README.md 中的安装链接。

Gemini CLI 扩展

仓库根目录是一个 Gemini CLI 扩展（gemini-extension.json）。

gemini extensions install https://github.com/Offline-Protocol/offline-protocol-agent-plugins

VS Code 搭配 GitHub Copilot

code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/[email protected]","mcp","serve"]}'

对于单个工作区，将 distribution/clients/vscode.json 复制到 .vscode/mcp.json。

Cline

cline mcp install offline-protocol -- npx -y @offline-protocol/[email protected] mcp serve

Devin

Devin CLI：

devin plugins install Offline-Protocol/offline-protocol-agent-plugins#plugins/offline-protocol

Devin（网页端）：添加自定义 MCP 服务，传输方式设为 stdio，命令设为 npx，参数设为 -y @offline-protocol/[email protected] mcp serve。Devin Desktop：distribution/clients/devin-desktop.json。

其他 MCP 客户端

使用以下服务定义（也位于 distribution/clients/mcp-stdio.json 中）：

{
  "mcpServers": {
    "offline-protocol": {
      "command": "npx",
      "args": ["-y", "@offline-protocol/[email protected]", "mcp", "serve"]
    }
  }
}

Zed、Continue、xAI 和托管配置位于 distribution/clients/README.md 和 distribution/clients/priority-two.md 中。

此仓库包含的内容

路径	内容
plugins/offline-protocol/	插件：Claude Code、Codex 和 Cursor 的清单、MCP 配置、集成技能和徽标
.claude-plugin/、.cursor-plugin/、.agents/plugins/	指向该插件的市场文件
gemini-extension.json	Gemini CLI 扩展清单
distribution/clients/	可直接合并到其他客户端的 MCP 配置
distribution/cline/offline-protocol/	Cline 市场条目
distribution/mcp-registry/	官方 MCP Registry 记录
.github/workflows/validate.yml	每次推送和拉取请求时运行的检查：对照 SOURCE.json 验证文件哈希、检查清单一致性、验证注册表架构并扫描密钥

发布版本使用 v<version> 作为标签，其中版本号取自 gemini-extension.json 和插件清单。插件版本与其启动的 CLI 版本相互独立。

许可证、隐私与安全

插件文件采用 Apache License 2.0 许可（LICENSE）。它们启动的 Offline Protocol CLI 同样采用 Apache-2.0 许可；安装到项目中的 SDK 保留各自的许可证，resolve_packages 工具会报告这些许可证。 Offline Protocol 名称和徽标是商标（NOTICE）。使用托管的 Offline Protocol 服务须遵守 https://www.offlineprotocol.com/legal/developer-terms 上的开发者条款以及 https://www.offlineprotocol.com/privacy 上的隐私政策。你的 Agent 客户端和模型提供商会依据各自的条款处理工具输入和结果。

请将安全问题报告至 [email protected]，不要在公开问题区报告（SECURITY.md）。