Spaceship Mcp

spaceship-mcp

Spaceship API 用の、コミュニティ開発の Model Context Protocol（MCP）サーバーです。ドメイン、DNS レコード、連絡先、マーケットプレイスの出品などを、MCP 対応の AI クライアントから自然言語で管理できます。

注記： これは非公式のコミュニティ保守プロジェクトであり、Spaceship とは提携しておらず、同社から承認も受けていません。

エディターに追加

CLI のワンライナーで、すぐに使い始められます。ツールを選択してください。

Claude Code

claude mcp add --scope user spaceship-mcp \
  --env SPACESHIP_API_KEY=your-key \
  --env SPACESHIP_API_SECRET=your-secret \
  -- npx -y spaceship-mcp

Codex CLI（OpenAI）

codex mcp add spaceship-mcp \
  --env SPACESHIP_API_KEY=your-key \
  --env SPACESHIP_API_SECRET=your-secret \
  -- npx -y spaceship-mcp

Gemini CLI（Google）

gemini mcp add spaceship-mcp -- npx -y spaceship-mcp

環境変数 SPACESHIP_API_KEY と SPACESHIP_API_SECRET は、~/.gemini/settings.json でそれぞれ個別に設定してください。

VS Code（Copilot）

コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開き、MCP: Add Server を選択して、Command (stdio) を選びます。

または、プロジェクトディレクトリの .vscode/mcp.json に追加します。

{
  "servers": {
    "spaceship-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "your-key",
        "SPACESHIP_API_SECRET": "your-secret"
      }
    }
  }
}

Cursor

.cursor/mcp.json（プロジェクト単位）または ~/.cursor/mcp.json（グローバル）に追加します。

{
  "mcpServers": {
    "spaceship-mcp": {
      "command": "npx",
      "args": ["-y", "spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "your-key",
        "SPACESHIP_API_SECRET": "your-secret"
      }
    }
  }
}

対応クライアント

この MCP サーバーは、Model Context Protocol に対応するあらゆるクライアントで動作します。以下はその一例です。

{
  "mcpServers": {
    "spaceship-mcp": {
      "command": "npx",
      "args": ["-y", "spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "your-key",
        "SPACESHIP_API_SECRET": "your-secret"
      }
    }
  }
}

{
  "mcpServers": {
    "spaceship-mcp": {
      "command": "npx",
      "args": ["-y", "spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "your-key",
        "SPACESHIP_API_SECRET": "your-secret"
      }
    }
  }
}

{
  "context_servers": {
    "spaceship-mcp": {
      "command": "npx",
      "args": ["-y", "spaceship-mcp"],
      "env": {
        "SPACESHIP_API_KEY": "your-key",
        "SPACESHIP_API_SECRET": "your-secret"
      }
    }
  }
}

docker run -i --rm \
  -e SPACESHIP_API_KEY=your-key \
  -e SPACESHIP_API_SECRET=your-secret \
  ghcr.io/bartwaardenburg/spaceship-mcp

任意のホストで、これを基本設定として使用します。

• コマンド： npx
• 引数： ["-y", "spaceship-mcp"]
• 必須の環境変数： SPACESHIP_API_KEY、SPACESHIP_API_SECRET
• 任意の環境変数： SPACESHIP_CACHE_TTL、SPACESHIP_MAX_RETRIES、SPACESHIP_TOOLSETS、SPACESHIP_DYNAMIC_TOOLS（設定を参照）

ホストごとのキーの対応：

Codex CLI（TOML 設定の代替方法）

~/.codex/config.toml を直接編集する場合：

[mcp_servers.spaceship-mcp]
command = "npx"
args = ["-y", "spaceship-mcp"]
env = { "SPACESHIP_API_KEY" = "your-key", "SPACESHIP_API_SECRET" = "your-secret" }

その他の MCP クライアント

MCP 対応クライアントでは、次のサーバー設定を使用します。

• コマンド： npx
• 引数： ["-y", "spaceship-mcp"]
• 環境変数： SPACESHIP_API_KEY と SPACESHIP_API_SECRET

Claude エコシステムに関する注意事項

Claude には、混同しやすい MCP 関連の概念がいくつかあります。

• ローカル MCP サーバー（Claude Desktop）： claude_desktop_config.json で定義し、お使いのマシンで起動します（ドキュメント）。
• Cowork： Claude Desktop に接続されている MCP サーバーを再利用します（ドキュメント）。
• コネクター： Claude で管理されるリモート MCP 統合機能です（ドキュメント）。
• Cowork プラグイン： Claude 固有のワークフロー用パッケージ（指示＋ツール／データ統合機能）です（ドキュメント）。Claude では便利ですが、他のエージェントクライアントで使用できる汎用 MCP サーバー設定として移植することはできません。

ベンダーのドキュメントに基づき、2026-03-05 に確認済みです。

用語

ホスト間で共通して使用できるもの：

• MCP サーバーの実行時設定（command、args、env）
• トランスポートモデル（stdio コマンドサーバー）
• このサーバーが公開するツール名とツールスキーマ

ホスト／ベンダー固有のもの（そのままでは移植できません）：

• ホスト設定のキー名（servers、mcpServers、context_servers、mcp_servers）
• サーバー追加時のホストの UX／ワークフロー（CLI コマンド、UI メニュー、設定のパス）
• Cowork のワークフローで使用される Claude Desktop のローカル MCP サーバー、リモート MCP 経由の Claude コネクター、Claude Code プラグインなどの Anthropic 固有の概念

• 48 個のツールで 8 カテゴリーをカバーし、Spaceship API 全体に対応
• 13 種類の DNS レコードに専用の型安全な作成ツールを用意（A、AAAA、ALIAS、CAA、CNAME、HTTPS、MX、NS、PTR、SRV、SVCB、TLSA、TXT）
• ドメインのライフサイクル全体に対応 — ドメインの登録、更新、移管、復元
• SellerHub との統合 — 販売用ドメインの一覧表示とチェックアウトリンクの生成
• DNS 整合性分析 — 期待されるレコードと実際のレコードを比較し、設定ミスを検出
• TLD 固有の属性に対応したWHOIS プライバシーと連絡先管理
• すべてのツールで Zod スキーマを使用した入力と出力の検証により、安全で予測可能な操作を実現
• パッシブなコンテキスト読み込みに対応する 5 つの MCP リソース（ドメイン一覧、ドメインの詳細、DNS レコード、連絡先、SellerHub）
• 9 つの MCP プロンプト — ガイド付きワークフロー 5 つと、引数の自動補完に対応するもの 4 つ
• ポーリングベースの変更検出と自動通知に対応するリソースサブスクリプション
• 設定可能な TTL と書き込み時の自動無効化に対応するレスポンスキャッシュ
• 指数バックオフと Retry-After ヘッダーに対応するレート制限処理
• 必要なツールカテゴリーのみを公開するツールセットのフィルタリング
• コンテキストウィンドウが制約されたエージェント向けの動的ツール読み込みモード
• コンテキストを考慮した復旧方法の提案を含む実用的なエラーメッセージ
• コンテナ化されたデプロイ向けのDocker サポート
• 453 件のユニットテストで、ほぼ完全なカバレッジ

設定

必須

Spaceship API Managerで認証情報を生成してください。

任意

API キーの設定

API キーの作成

1. Spaceship アカウントにログインします
2. API Managerに移動します（直接リンク）
3. New API keyをクリックします
4. キーにわかりやすい名前（例：「MCP Server」）を付けます
5. 必要なスコープを選択します（以下を参照）
6. API キーとAPI シークレットの両方をコピーします — シークレットが表示されるのは一度だけです

利用可能なスコープ

各スコープは、Spaceship API の特定の部分へのアクセスを制御します。キーを作成する際は、必要なスコープのみを有効にしてください。

機能ごとのスコープ

以下の表は、ツールの各グループで必要なスコープを示しています。

推奨スコープのプリセット

フルアクセス — 制限なく使用できるよう、すべてを有効にします。

domains:read  domains:write  domains:billing  domains:transfer
contacts:read  contacts:write
dnsrecords:read  dnsrecords:write
sellerhub:read  sellerhub:write
asyncoperations:read

DNS 管理のみ — DNS レコードの読み取りと書き込みのみを行います。

dnsrecords:read  dnsrecords:write

読み取り専用 — 変更を加えずにドメインとレコードを参照します。

domains:read  contacts:read  dnsrecords:read  sellerhub:read  asyncoperations:read

利用可能なツール

DNS レコード

タイプ別レコード作成

各 DNS レコードタイプには、型安全なパラメーターと検証機能を備えた専用ツールがあります。

ドメイン管理

ドメインのライフサイクル

連絡先とプライバシー

パーソナルネームサーバー

SellerHub

分析

MCP リソース

リソースは、クライアントがツールを呼び出さずに読み込める受動的なコンテキストを提供します。

リソースのサブスクリプションに対応するクライアントは、データが変更されると自動通知を受け取ります（30秒ごとにポーリング）。

MCP プロンプト

プロンプトは、クライアントがスラッシュコマンドやクイックアクションとして提示できる、ガイド付きのワークフローを提供します。

ガイド付きワークフロー

オートコンプリートプロンプト

これらのプロンプトでは、ドメイン名や一般的な値の引数をオートコンプリートできます。

ツールセットのフィルタリング

必要なツールカテゴリのみを有効にして、コンテキストウィンドウの使用量を削減できます。SPACESHIP_TOOLSETS 環境変数に、カンマ区切りのリストを設定します。

SPACESHIP_TOOLSETS=dns,domains

設定しない場合は、すべてのツールセットが有効になります。無効な名前は無視されます。すべての名前が無効な場合は、フォールバックとしてすべてのツールセットが有効になります。

動的なツールの読み込み

コンテキストウィンドウに制限のあるエージェント向けに、動的モードでは 48 個すべてのツールが、軽量なメタツール 3 個に置き換わります。

SPACESHIP_DYNAMIC_TOOLS=true

ワークフロー：

1. search_tools({ query: "dns" }) — 関連するツールを見つけます
2. describe_tools({ tools: ["create_a_record"] }) — 完全なパラメータスキーマを取得します
3. execute_tool({ tool: "create_a_record", arguments: { ... } }) — 実行します

リソース、プロンプト、補完機能は、動的モードでも引き続き利用できます。

セキュリティに関する注意事項

• 信頼モデル： この MCP サーバーを呼び出すことが許可されたプロンプトやエージェントは、設定済みの認証情報を使って Spaceship API の操作を実行できます。
• 最小権限の認証情報： 環境／チーム／用途ごとに個別の Spaceship API キーを使用し、必要なスコープのみを有効にしてください（利用可能なスコープを参照）。
• 書き込み操作の承認： 変更を行うツール（register_domain、create_*、update_*、delete_*、save_*、set_*、およびライフサイクル操作）に対して、ホスト側の承認を有効にしてください。
• チーム設定のガバナンス： 共有 MCP 設定はバージョン管理に保存し、コマンド／引数／環境変数／ツールセットフィルタリングの変更にはレビューを必須としてください。また、シークレットは保管庫またはホストのシークレットマネージャーに保存してください（リポジトリ内の平文ファイルには保存しないでください）。

使用例

接続後は、自然言語で Spaceship API を操作できます。

• 「自分のドメインをすべて一覧表示する」
• 「example.com が登録可能か確認する」
• 「api.example.com の A レコードを作成して、203.0.113.10 を指定する」
• 「example.com に Google Workspace 用の MX レコードを設定する」
• 「example.com の WHOIS プライバシーを有効にする」
• 「example.com の DNS レコードが期待どおりか確認する」
• 「SellerHub で販売中の自分のドメインを一覧表示する」
• 「example.com を Spaceship に移管する」

コミュニティ

• サポート：SUPPORT.md
• セキュリティに関する報告：SECURITY.md
• 貢献ガイドライン：CONTRIBUTING.md
• バグ報告と機能リクエスト：Issues

開発

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

# Type check
pnpm typecheck

プロジェクト構成

src/
  index.ts                    # Entry point (stdio transport)
  server.ts                   # MCP server setup, toolset filtering, feature registration
  spaceship-client.ts         # Spaceship API HTTP client with caching and retry
  cache.ts                    # TTL-based in-memory response cache
  schemas.ts                  # Shared Zod validation schemas
  output-schemas.ts           # Zod output schemas for all 48 tools
  types.ts                    # TypeScript interfaces
  tool-result.ts              # Error formatting with recovery suggestions
  resources.ts                # MCP Resources (5 resources)
  resource-subscriptions.ts   # Polling-based resource change notifications
  prompts.ts                  # MCP Prompts (5 guided workflows)
  completions.ts              # MCP Prompts with argument auto-complete (4 prompts)
  dynamic-tools.ts            # Dynamic tool loading meta-tools
  dns-utils.ts                # DNS record formatting utilities
  update-checker.ts           # NPM update notifications
  tools/
    dns-records.ts            # List, save, delete DNS records
    dns-record-creators.ts    # 13 type-specific DNS record creation tools
    domain-management.ts      # Domain listing, settings, nameservers
    domain-lifecycle.ts       # Registration, renewal, transfer, restore
    contacts-privacy.ts       # Contact profiles and WHOIS privacy
    personal-nameservers.ts   # Vanity/glue nameserver management
    sellerhub.ts              # Marketplace listing and checkout tools
    analysis.ts               # DNS alignment analysis

要件

• Node.js >= 20
• API 認証情報を持つ Spaceship アカウント

ライセンス

MIT - 詳細は LICENSE を参照してください。