Globestudio

@globestudio/mcp

Globestudio 用の Model Context Protocol サーバーです。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 のコネクタディレクトリで開く。または「カスタマイズ」を開き、「コネクタ」を選択して、+ をクリックし、カスタムコネクタを追加を選択します。https://globestudio.app/mcp を貼り付けて、追加をクリックします。カスタムコネクタは Free（コネクタ 1 つ）、Pro、Max、Team、Enterprise の各プランで利用できます。Team と Enterprise では、まずオーナーが追加する必要があります。

ChatGPT： ChatGPT で開き、プラグインをインストールを押します。このプラグインにはツールと 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（1 つのプロジェクト）に追加します。

{
  "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 のツールがツールカタログに表示されます。

機能

ツールは 6 つあります。プリセットカタログがパッケージに含まれているため、外部 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 })	1 つのプリセットについて、正規のライブ /embed URL と PNG サムネイル URL を返します。

各ツールには「スタイルからスタイルを検索」のような短いタイトルが付いており、リンクの生成または読み取りのみを行うため、読み取り専用、非破壊、クローズドワールドとしてマークされています。ChatGPT は、読み取り専用マークのないツールを書き込み操作として扱い、ユーザーに確認を求めます。

プロンプト例

「Globestudio のレトロな雰囲気のプリセットをすべて見せてください。」

「シアンのドットを使ったシンプルな点描の地球儀を作り、共有 URL を教えてください。」

「Vapor プリセットを 1200×600 で表示する React コンポーネントを生成してください。」

「私の地球儀はこちらです：https://globestudio.app/?c=… ドットを赤にして、ヨーロッパだけを表示してください。」

プライバシー

ホスト型サーバーが読み取るのは、ルック ID、スタイルを表す単語、色、地域、Globestudio のリンクなど、各ツール呼び出しの引数のみです。それらと組み込みのルック一覧を使って応答し、何も保持しません。ストレージ、アカウント、Cookie はなく、他のサービスへの呼び出しもありません。会話の残りの部分を見ることはありません。ホストである Vercel は、他のウェブホストと同様に各リクエストの IP アドレスを確認し、各リクエストの時刻、IP アドレス、パス、ステータス、ユーザーエージェント、地域を含むリクエストログを最大 30 日間保持しますが、ツールの引数は記録しません。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」。 リクエストが大きすぎます。設定を減らすか、1 回に 1 つずつ呼び出してください。
• 上記以外の場合。 GitHub で issue を作成してください。

ソース

このパッケージは Globestudio モノレポの一部です。プリセットカタログは、メインアプリの src/data/look-presets.js を反映しています。新しいプリセットは、同じリリースでここにも追加されます。

ライセンス

MIT です。LICENSEをご覧ください。