Soleil Clusters

soleil-clusters-mcp

适用于 Soleil Clusters 的 MCP 服务——通过 Claude 或任何 Model Context Protocol 客户端读取并构建视觉看板。

你可能不需要这个软件包

我们提供了一个托管服务，现在它会自动为你登录。只需将客户端指向一个 URL：

{
  "mcpServers": {
    "soleil-clusters": {
      "type": "http",
      "url": "https://clusters.soleilpictures.com/api/v1/mcp"
    }
  }
}

无需令牌。首次调用会返回 401，并附上 OAuth 元数据的链接；客户端会自行注册、打开浏览器，你只需在一个页面上批准连接。如果你还没有账户，也可以在那里创建——登录时只需填写电子邮箱。

仅当你需要托管服务无法提供的一个工具时，才安装此软件包：upload_file。该工具可以读取你本机磁盘上的文件，包括无法通过助手消息传输的大型媒体文件。

npx soleil-clusters-mcp login

{
  "mcpServers": {
    "soleil-clusters": {
      "command": "npx",
      "args": ["-y", "soleil-clusters-mcp"]
    }
  }
}

login 会在终端中执行相同的 OAuth 流程：打开浏览器，在环回端口接收回调，并将凭据存储到 ~/.config/soleil-clusters/credentials.json（权限模式为 600）。之后会自动刷新凭据。运行 npx soleil-clusters-mcp logout 可将其移除。

更喜欢使用令牌？SOLEIL_API_TOKEN 仍然有效，且优先级更高——在 Settings → Connections 下创建令牌。SOLEIL_API_BASE 可用于覆盖主机。

功能

提供 31 个工具：搜索和获取内容，读取、编写和导出看板及文档，查看整个看板或其中的图片，按布局向你展示看板（如果应用支持绘图，就会在聊天中绘制），批量创建和更改看板及卡片，将看板排成齐边行或瀑布流，通过链接分享，读取、添加和解决评论，列出标签并为卡片添加标签，从 URL 导入，为内容附加其他系统中的标识符，移动和删除内容，以及读取审计日志。另有 5 个提示词：根据简介制作情绪板、审阅看板、整理看板、根据看板撰写方案，以及规划导入。

3.0 版将 15 个工具合并到了其他工具中（例如，将 get_board 合并到 read_board，将 update_card 合并到 update_cards 等）。调用旧名称时会告知你现在应使用哪个工具。

完整参考文档：https://clusters.soleilpictures.com/docs/mcp

权限

此服务本身不持有任何凭据，也不实现权限控制。它会转发你的令牌，由 API 将其解析为你的会话——因此，Agent 只能访问你的账户可访问的内容，数据库会拒绝其他访问。

共有三个作用域：read、write、delete。删除权限与写入权限刻意分开，这样就可以允许 Agent 创建内容，同时不允许其销毁内容。login 会请求 read write，绝不会请求 delete。

你连接的任何应用都会显示在 Settings → Connections → Connected apps 下，其中会列出它执行过的操作，并提供断开连接的按钮。

开发

src/tools.js 和 src/server.js 是从 boards/src/lib/mcpTools.js 和 boards/src/lib/mcpServer.js 生成的，托管服务也使用这两个源文件。请编辑这两个文件，然后：

npm run sync

boards/ 中的测试会在任一副本过期时失败，以确保两种传输方式不会出现偏差。

发布

server.json 用于描述此服务，以便将其提交到 MCP Registry。其中的 name 必须与 package.json 中的 mcpName 一致，而 com.soleilpictures 命名空间则来自 soleilpictures.com 顶级域上的 DNS TXT 记录。

npm publish --access public
mcp-publisher login dns --domain soleilpictures.com --private-key <hex>
mcp-publisher publish