vibewatch-mcp

将任意 MCP 客户端连接到你的 Vibewatch 社区情绪数据。

Vibewatch 的 MCP 服务器针对你组织的数据提供七个只读工具——情绪概览、情绪趋势、消息搜索、每日洞察、每周报告、市场背景和组织详情。本包是通往该服务器的轻量 stdio 桥接器：它封装了 mcp-remote，内置 Vibewatch 服务器 URL 和认证处理，并为 Buzz 智能体提供一条命令的安装配置。

与 Buzz 一起使用

两条命令，一次浏览器授权：

npm install -g vibewatch-mcp
vibewatch-mcp connect-buzz

connect-buzz 会在浏览器中为你登录 Vibewatch（无需生成或复制密钥），缓存登录状态以供无头环境复用，然后在你机器上找到的每个智能体框架中注册该桥接器——包括 Claude Code、Codex 和 Goose。重启你的 Buzz 智能体后，它们就能回答来自你社区数据的问题。

需要 Node 18+。MCP 访问按组织选择启用——由所有者或管理员在 app.vibewatch.io → Settings → API Access 中开启。

值得了解：

• 注册是用户级的：你机器上已配置框架的每个会话都可以查询 Vibewatch，而不仅仅是 Buzz 启动的会话。这些数据是你组织的只读社区情绪数据。

• 要切换组织，请运行 vibewatch-mcp connect-buzz --reset。

• 升级 vibewatch-mcp 后，请再运行一次 connect-buzz——缓存的登录状态与捆绑的 mcp-remote 版本绑定。

• 要撤销：运行 claude mcp remove --scope user vibewatch、codex mcp remove vibewatch，或从 ~/.config/goose/config.yaml 中删除 extensions.vibewatch 条目（Windows：%APPDATA%\Block\goose\config\config.yaml）。你可以随时在 Settings → API Access 中撤销该应用的访问权限。

如需完整的 Vibewatch-on-Buzz 安装——将报告投递到频道，外加一个现成的 @vibewatch 角色——请打开 app.vibewatch.io 中 Settings → Reports 下的 Buzz tile，并按照设置指南操作。

Related MCP server: Feedback Synthesis MCP

无头 / CI 环境：改用密钥

在无法通过浏览器登录的环境中，组织级密钥可以在桥接器运行的任何地方使用：

1. 在 app.vibewatch.io 中，打开 Settings → API Access 并生成一个密钥。密钥以 vw_mcp_ 开头，且只显示一次——请像保管密码一样保存它们。

2. 将其传给 connect-buzz（vibewatch-mcp connect-buzz --key vw_mcp_...），或直接在桥接器运行处设置：

claude mcp add --scope user vibewatch -e VIBEWATCH_MCP_KEY=vw_mcp_... -- vibewatch-mcp

密钥是组织级且只读的；你可以随时在同一个界面撤销它们。

与任意 stdio MCP 客户端一起使用

通用客户端配置（Claude Desktop 及兼容客户端）。macOS 上的 GUI 应用以最小 PATH 启动，因此请使用 which vibewatch-mcp 输出的绝对路径：

{
  "mcpServers": {
    "vibewatch": {
      "command": "/opt/homebrew/bin/vibewatch-mcp"
    }
  }
}

如果未设置 VIBEWATCH_MCP_KEY，桥接器会使用缓存的浏览器登录状态（运行一次 connect-buzz 即可创建——或者客户端的首次连接会自行打开登录页面）。如需改用密钥，请添加包含 VIBEWATCH_MCP_KEY 的 env 块。

桥接器负责管理登录标签页：在桥接器下，mcp-remote 自带的浏览器自动打开功能会被禁用，由桥接器自行打开登录页面——无论有多少个智能体会话在运行，每台机器每次登录最多只打开一个标签页。这也覆盖了会话中途的重新认证（登录状态被撤销或过期且存在多个活动会话时，只会打开一个标签页，而不是每个会话一个）。如果登录页面一直未完成，桥接器不会再打开新的：后续启动的进程（重启服务器的客户端、其他智能体会话）会退出并提示运行 vibewatch-mcp connect-buzz，而不是打开更多标签页。通过 connect-buzz 登录（或完成已打开的标签页）即可解除该状态；24 小时后，未响应的提示会过期，届时允许再次打开一个新的登录页面。在 Windows 上，同时启动的智能体会话也会相互协调，只会有一个会话打开登录页面——其他会话会等待其完成。

环境变量

额外的 CLI 参数（例如 --debug）会透传给 mcp-remote。

桥接器绝不会把密钥放到进程参数列表中——它向 mcp-remote 传递 ${VIBEWATCH_MCP_KEY} 占位符，由 mcp-remote 从环境中读取该值。有一点需要注意：connect-buzz --key 驱动的是框架 CLI（claude mcp add -e ...、codex mcp add --env ...），这些 CLI 只接受以参数形式传入的环境变量值，因此密钥会短暂出现在这些短生命周期进程的 argv 中。如果你在意这一点，请改用浏览器登录——它完全不涉及密钥。

工具

许可证

Apache-2.0