Globestudio

@globestudio/mcp

适用于 Globestudio 的模型上下文协议服务。它让兼容 MCP 的 AI 助手可以通过聊天创建点状地球仪地图、生成分享 URL 并获取嵌入代码片段。

通过 URL 连接（无需安装）

Globestudio 在 https://globestudio.app/mcp 托管此服务（可流式传输的 HTTP）。无需安装任何内容，也不需要账号或 API 密钥。

Claude Code

claude mcp add --transport http globestudio https://globestudio.app/mcp

Claude（claude.ai 和 Claude Desktop）：在 Claude 的连接器目录中打开。或者打开 Customize，然后选择 Connectors，点击 +，再点击 Add custom connector。粘贴 https://globestudio.app/mcp 并点击 Add。Free（一个连接器）、Pro、Max、Team 和 Enterprise 方案均支持自定义连接器；在 Team 和 Enterprise 方案中，需先由 Owner 添加。

ChatGPT：在 ChatGPT 中打开，然后按 Install plugin。此插件会提供工具和 Globestudio 技能。

Codex

codex mcp add globestudio --url https://globestudio.app/mcp

或者将其添加到 ~/.codex/config.toml：

[mcp_servers.globestudio]
url = "https://globestudio.app/mcp"

**Cursor：**将其添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "globestudio": {
      "url": "https://globestudio.app/mcp"
    }
  }
}

也可以打开此链接，一键安装：

cursor://anysphere.cursor-deeplink/mcp/install?name=globestudio&config=eyJ1cmwiOiJodHRwczovL2dsb2Jlc3R1ZGlvLmFwcC9tY3AifQ==

**任何其他 MCP 客户端：**使用可流式传输的 HTTP 传输方式，将 https://globestudio.app/mcp 添加为远程服务。

托管服务是无状态的：每个请求都会启动一个全新的服务，请求之间不会存储任何内容，回复均为纯 JSON。服务仅接受 POST（GET 和 DELETE 返回 405），请求大小最多为 128 KB，每批最多 10 条消息。

在本地运行（stdio）

适用于 Claude Code：

claude mcp add globestudio -- npx -y @globestudio/mcp

对于 Claude Desktop，将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "globestudio": {
      "command": "npx",
      "args": ["-y", "@globestudio/mcp"]
    }
  }
}

对于 Cursor、Cody、Continue 或任何其他基于 MCP-over-stdio 的客户端：以相同方式将其指向 npx -y @globestudio/mcp。

重启 AI 工具。Globestudio 工具现在应会出现在工具目录中。

功能

共有六个工具。它们都不会调用外部 API，因为预设目录包含在软件包中：

工具	用途
list_presets	列出所有内置风格：id、名称、简介、风格标签、缩略图 URL 和嵌入 URL。
find_presets({ vibe })	按风格词或短语查找风格。synthwave → Vapor；print → Halftone / Risograph / Newsprint；glow → Aurora / Bloom；retro print → 优先显示 Halftone。
build_share_url({ look?, share_url?, selection?, dotColor?, ..., config? })	生成地球仪 URL：工作室分享 URL 和 /embed URL。可以从一种风格开始，也可以将链接作为 share_url 传入，只提供要更改的设置；链接中的其他内容都会保留。config: { viewSwitch: true } 可为嵌入内容添加 Globe 和 Map 切换选项。
read_share_url({ url })	将 Globestudio 链接（工作室分享链接、/looks/<id> 链接或 /embed URL）解码为对应的风格和设置，让助手可以修改你粘贴的链接。
embed_snippet({ look, framework })	可直接粘贴的代码：iframe HTML、react 组件或 script-tag 加载器。
preview_url({ look })	获取某个预设的规范 /embed URL 和 PNG 缩略图 URL。

每个工具都有简短标题，例如“按风格查找外观”，并被标记为只读、非破坏性且仅限封闭范围，因为它只会生成或读取链接。ChatGPT 会将未标记为只读的工具视为写入操作，并要求用户确认。

示例提示词

“展示所有具有复古风格的 Globestudio 预设。”

“为我制作一个简洁的点状地球仪，使用青色圆点，并提供分享 URL。”

“为 Vapor 预设生成一个 1200×600 的 React 组件。”

“这是我的地球仪：https://globestudio.app/?c=… 将圆点改为红色，并且只显示欧洲。”

隐私

托管服务只读取每次工具调用的参数，例如外观 ID、风格词、颜色、区域或 Globestudio 链接。它根据这些参数和内置的外观列表作答，不会保留任何内容：没有存储、账号、Cookie，也不会调用任何其他服务。它绝不会看到你对话的其余内容。托管该服务的 Vercel 会像其他 Web 主机一样看到每个请求的 IP 地址，并最多保留 30 天的请求日志，其中记录每个请求的时间、IP 地址、路径、状态、用户代理和区域，而不记录工具参数。在本地运行 npx -y @globestudio/mcp 时，服务不会向任何地方发送数据。完整政策请见 globestudio.app/privacy，使用条款请见 globestudio.app/terms。

故障排除

• 工具没有显示。 请检查 URL 是否准确为 https://globestudio.app/mcp，以及客户端是否使用可流式传输的 HTTP（在 Claude Code 中使用 --transport http）。在浏览器中打开该 URL 会显示“Method not allowed”。这是预期行为：该端点仅接受 POST 请求。
• “Unknown preset”。 请请求外观列表（list_presets），并使用返回的其中一个 ID。
• “is not a URL”。 read_share_url 和 share_url 接受完整的 Globestudio 链接：带有 ?c= 的工作室链接、/looks/<id> 链接或 /embed URL。
• “Request body is larger than 128 KB” 或 “A batch can hold up to 10 messages”。 请求内容过大。请减少设置数量，或每次只进行一次调用。
• 其他问题。 请在 GitHub 上提交问题。

源码

此软件包是 Globestudio monorepo 的一部分。预设目录与主应用中的 src/data/look-presets.js 保持一致。新增预设会在同一版本中加入此处。

许可证

MIT。请参阅 LICENSE。