SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具mcp-server

mcp-server

Yocoolab mcp-server 是一个基于 MCP（Model Context Protocol）的服务器，可将 Yocoolab 的视觉反馈线程和设计选区以工具形式暴露给 Claude Code、Cursor 及其他兼容 MCP 的客户端。安装后，AI 编程助手可以列出并处理仓库中打开的设计反馈线程、拉取线程的丰富上下文（选区、截图、对话、涉及文件）、回复设计师并将线程标记为已处理，以及创建关闭反馈线程的 PR。该工具还支持读取 Yocoolab Chrome 扩展的元素上下文与选区历史、同伴聊天消息、AI 对话以及 Pendo 产品分析数据。设置向导会自动检测已安装的 AI 代理（Claude Code、Cursor、Cline、Roo Code、Windsurf）并写入对应的 MCP 配置，重启代理后即可使用。

访问官网

工具介绍

用途

@yocoolab/mcp-server 是一个 MCP（Model Context Protocol）服务器，用于把 Yocoolab 的视觉反馈线程和设计选区作为工具提供给 Claude Code 及其他兼容 MCP 的客户端。其核心目标是让 AI 编程助手能够直接访问并处理来自 Yocoolab Chrome 扩展的设计反馈，从而在编码流程中闭环处理设计意见。

主要能力

安装后，AI 编程助手可以执行以下操作：

  • 列出并分类仓库中打开的设计反馈线程
  • 拉取某个线程的丰富上下文（选区、截图、对话、涉及的文件）
  • 回复设计师并将线程标记为已处理
  • 创建关闭反馈线程的 PR
  • 从 Yocoolab Chrome 扩展获取元素上下文和选区历史
  • 读取同伴聊天消息、AI 对话以及 Pendo 产品分析数据

服务器暴露的工具分为以下几类：

  • Threads：list_open_threads、get_thread_context、add_thread_message、mark_thread_addressed、create_pr_for_thread
  • Selection / Bridge：get_latest_selection、get_selection_history、get_element_context、find_source_for_selection、ai_analyze_page
  • Companion：get_companion_messages、reply_to_companion
  • AI：get_ai_conversations
  • Deployment：get_deployment_preview
  • Pendo（可选）：pendo_list_guides、pendo_page_analytics、pendo_feature_usage、pendo_track_event

完整工具描述和参数会在服务器启动后由 MCP 客户端列出。

使用方式

设置向导会自动检测已安装的 AI 代理（Claude Code、Cursor、Cline、Roo Code、Windsurf）并分别写入正确的 MCP 配置。重启代理后，yocoolab 服务器会出现在工具列表中。

init 保留为 setup 的别名，以兼容 v1.0.x 的安装说明。

如需手动配置，等效的 ~/.mcp.json 内容如下（原文未提供完整示例，仅说明格式）。

版本锁定说明：@3 版本锁定保持在 v3 主线上，可自动接收 bug 修复和新功能，未来 v4 的破坏性变更不会影响现有设置。v3.0.0 移除了活动监视器，不再向 ~/.claude/settings.json 写入 Claude Code hooks；从 v2 升级请参阅 CHANGELOG.md。

环境要求：

  • Node.js 20 或更高版本。CI 在 Node 20 和 22 上测试。支持当前处于 Active LTS 或 Maintenance LTS 状态的 Node.js 版本，并在 EOL 后 30 天内放弃支持。Node 18 已在 v2.0.0 中放弃（EOL 2025 年 4 月）。
  • 一个 Yocoolab 账户和 JWT 令牌——可从 Yocoolab Chrome 扩展设置或 app.yocoolab.com 账户获取。
  • 若要使用 PR 创建工具（create_pr_for_thread），需要一个具有 repo 权限的 GitHub 个人访问令牌。如果已安装 GitHub CLI 并完成认证（gh auth login），令牌会被自动检测，无需 GITHUB_TOKEN 环境变量。否则可在 github.com/settings/tokens/new?scopes=repo 创建。

mcp-server 命令是 yocoolab-mcp 的同义词，两者均可使用。

对于仅链接项目（无 GitHub App 连接）：使用自己的 git/gh 打开 PR，然后调用 mark_thread_addressed 并传入 pr_url（有 pr_branch、preview_url 时一并传入）。PR 字段会落到线程上，预览链接进入审查消息；get_thread_context 会打印项目的仓库链接，以便确认指向的仓库。create_pr_for_thread 保留给已连接 GitHub 的 owner/name 工作区。

故障排除

  • yocoolab-mcp: command not found——确认版本为 v1.0.1 或更高。运行 npx -y @yocoolab/mcp-server@latest setup 获取当前版本。
  • [yocoolab] Warning: YOCOOLAB_TOKEN not set——没有令牌时线程反馈工具被禁用，但 bridge / companion / selection 工具仍可用。要启用全部功能，运行 yocoolab-mcp setup 重新生成配置并填入 JWT。
  • 安装后工具未出现在代理中——完全重启代理（退出并重新打开）。MCP 服务器在启动时加载。
  • 端口 9800 已被占用——另一个 MCP 服务器实例正在运行，或其他应用占用了该端口。在 .mcp.json 中将 YOCOOLAB_BRIDGE_PORT 设为其他值（如 9801）。
  • 详细诊断日志——在 env 块中设置 DEBUG=yocoolab:*。所有诊断输出到 stderr（不会干扰 stdout 上的 MCP stdio 协议）。
  • PR 创建提示 "GitHub token not configured"——create_pr_for_thread 工具需要 GitHub 令牌。两种修复方式：自动检测（最简单）：安装 GitHub CLI 并运行 gh auth login，服务器会自动获取令牌。手动：创建具有 repo 权限的个人访问令牌，并在 MCP 配置的 env 块中添加 GITHUB_TOKEN: "ghp_..."。如果配置中是占位符值如 <your GitHub PAT>，服务器会检测到并显示提示信息，而不是以 401 崩溃。

适用场景

适用于使用 Yocoolab Chrome 扩展收集网页视觉反馈、并希望让 AI 编程助手（如 Claude Code、Cursor、Cline、Roo Code、Windsurf）直接读取和处理这些设计反馈的开发者与团队。可将设计反馈线程与代码修改、PR 创建流程打通。

限制

  • 需要 Node.js 20 或更高版本。
  • 线程反馈工具需要 Yocoolab 账户和 JWT 令牌；没有令牌时部分工具不可用。
  • PR 创建工具需要 GitHub 令牌（repo 权限），或已安装并认证的 GitHub CLI。
  • Pendo 相关工具为可选功能。
  • 文档方面：本 README 加 MCP 客户端中可见的内联工具描述；错误报告见 github.com/Yocoolab/mcp-server/issues（使用 bug 模板）；安全问题见 SECURITY.md，不要开公开 issue；其他问题联系 support@yocoolab.com；贡献流程见 CONTRIBUTING.md。

安全与供应链

  • 发布时带 npm provenance——每个发布版本都由 GitHub Actions OIDC 加密签名，可追溯到确切的提交和工作流运行。
  • 每次发布附带 CycloneDX SBOM 到 GitHub Release。
  • CI 在每个 PR 上运行 npm audit signatures 和 CodeQL 静态分析。
  • 漏洞报告见 SECURITY.md。

许可证：Apache 2.0——© 2026 Yocoolab。

同类工具

查看分类