Pinako Ai Bridge

Pinako AI Bridge

将浏览器标签页和资料库连接到 Claude Desktop、Cursor，以及 AI 能访问的其他所有内容。

Model Context Protocol（MCP）桥接工具，可将 Pinako（用于管理标签页树的 Chromium 扩展）连接到本地 AI 客户端，包括 Claude Code、Claude Desktop、Cursor、ChatGPT-Codex、VS Code（Copilot Agent 模式）、Antigravity、Grok Build、Kimi Code、OpenClaw、Hermes、Cline、Zoo Code，以及任何 HTTP MCP 客户端。检测到旧版 Windsurf、Roo Code、Continue.dev 和 Gemini CLI 安装时，也会为其配置。

此桥接工具会在你的电脑上作为一个小型原生消息传递主机运行，并将 Pinako 的标签页树、资料库、资料库组、Main Notes 和浏览器书签作为 MCP 工具提供。它提供完整的读写功能：AI 助手既可以查询浏览器状态，也可以重新整理内容——移动和嵌套标签页、创建资料库、资料库组和文件夹、编辑标题、标签、备忘录、颜色和笔记、查找并移除重复项，以及将大量编辑作为一个可撤销步骤批量应用。

由于此桥接工具在 Claude Desktop、Cursor 和 Codex 等桌面 AI 客户端中运行，同一个助手可以在 Pinako 与其连接的其他工具、文件和服务之间传递信息。例如：

• “将这个研究资料库的笔记复制到 Google 文档。”
• “根据我的 Competitors 资料库中的标签页制作一个电子表格。”
• “访问 Reading 资料库中的 URL，并撰写一份摘要。”
• “按主题将打开的标签页整理到不同资料库中，然后为工作相关的标签页添加标签。”
• “查找并移除重复书签。”

写入操作遵循与扩展自身 UI 相同的层级限制、确认和撤销机制。破坏性操作（删除、书签重新排序）会返回 CONFIRMATION_REQUIRED 结果，直到调用方明确确认；bulk_apply 批次则会作为一个撤销步骤原子性地应用。每次写入都会返回结构化的 {ok, error} 结果，客户端可据此根据错误代码进行处理。

工具

读写 MCP 工具。各工具及其参数的完整参考：pinako.pro/docs/ai-connect。

读取——查询树、资料库、笔记和书签，并进行搜索

get_tree、get_tree_summary、search_tabs、search_pinako、search_docs、list_libraries、get_library、get_main_tree_notes、get_bookmarks、list_browsers、find_duplicates

树结构——移动、嵌套、分组和移除节点

move_node、indent_node、outdent_node、create_group、create_folder、ghost_node、delete_node、delete_live_node、bulk_apply（最多 250 个原子子操作，作为一个步骤撤销）

节点元数据——标题、标签、备忘录、颜色

set_title、set_tags、add_tags、remove_tags、set_memo、set_star_color、set_row_color

资料库和资料库组——创建、编辑、删除和整理

create_library、add_to_library、set_library_title、set_library_description、delete_library、create_library_group、set_library_group_title、set_library_group_description、delete_library_group、add_library_to_group、remove_library_from_group、reorder_library_panel、reorder_libraries_in_group

笔记——创建和编辑 Main Notes 与资料库笔记

create_note、set_note_content、delete_note

书签——写入浏览器书签树

add_to_bookmarks（使用 get_bookmarks 读取书签；使用 find_duplicates 查找重复项）

读取工具可安全地自动批准。写入工具均单独标注了幂等、非幂等或破坏性属性，MCP 客户端可据此进行适当限制。

安装

含截图和各客户端说明的设置指南：pinako.pro/docs/ai-connect

下载：pinako.pro/downloads

可用安装程序：

• Windows——图形化安装程序（.exe）
• Linux x64 和 Linux ARM64——命令行安装程序

要求

• 浏览器中已安装 Pinako 扩展（Chrome 网上应用店）
• 拥有有效的 Pinako 订阅（Pro 或更高级别）——该桥接服务受订阅限制

本地访问与访问令牌

该桥接服务监听 127.0.0.1:37421，仅处理回环请求——它会拒绝任何带有浏览器 Origin 或非回环 Host 的请求，因此网页即使通过 DNS 重绑定也无法访问它。

此外，使用写入工具需要机器本地访问令牌。安装程序会生成该令牌，并将其写入每个 AI 客户端的配置 URL：

http://127.0.0.1:37421/mcp?token=<your-token>

该令牌存放在 Pinako 数据目录中，与服务二进制文件位于同一目录（Windows 上为 %APPDATA%\Pinako\mcp-auth-token，Linux 上为 ~/.local/share/pinako/，macOS 上为 ~/Library/Application Support/Pinako/），且只有你的用户帐户可读取。对于支持自定义标头的客户端，也可以使用 Authorization: Bearer <token>。

**请将此 URL 视同密码。**任何持有该 URL 的人都能读取和更改你的标签页、资料库和笔记。

未配置令牌的客户端仍可连接并读取，但其写入工具会返回消息，提示你重新运行安装程序。这样可确保现有配置在升级后继续使用；重新运行安装程序即可恢复完整访问权限。

要撤销已共享或粘贴到公开位置的令牌：

Linux（CLI 安装程序）——重新生成密钥，并一步重写所有检测到的客户端配置：

pinako-ai-bridge-cli-linux-x64 rotate-token

Windows / macOS——GUI 安装程序没有轮换命令，因此请使用服务二进制文件轮换令牌，然后重新运行安装程序以更新应用：

"%APPDATA%\Pinako\pinako-mcp-service.exe" --rotate-token

旧令牌会立即失效：运行中的 Bridge 会检测到更改，并断开所有已授权的会话。在你重新运行安装程序之前，仍持有旧 URL 的应用会被拒绝访问，并收到相应提示消息。

从源代码构建

git clone https://github.com/teleomorph/pinako-mcp.git
cd pinako-mcp
npm install
node setup/build.js --all

输出文件位于 dist/。构建标志（--all、--no-tauri、--no-cli）请参阅 setup/build.js。

Tauri GUI 安装程序只能在其目标平台上构建（即在 Windows 上构建 Windows 安装程序）。CLI 安装程序可在任意主机上为所有列出的平台进行交叉编译。

架构

• host.js — MCP 服务 / Chrome 原生消息传递主机
• setup/main.js — CLI 安装程序（写入原生消息传递主机 JSON，配置受支持的 AI 客户端）
• setup/build.js — 多阶段构建（esbuild → pkg → Tauri）
• installer/src-tauri/ — 用于 Windows 的 Rust Tauri GUI 安装程序

许可证

MIT