AiVikings.ai

AiVikings.ai MCP サーバー（公式）

Model Context Protocolに対応する、AiVikings.aiの公式サーバーです。AiVikings.aiはAIエージェント向けに構築されたドメイン登録サービスです。ChatGPT、Claude、Cursorなど、MCPに対応するあらゆるエージェントから、ドメインの空き状況の確認、登録と更新、DNS、連絡先、移管の管理を行えます。

インストールは不要です。 AiVikings.aiは次のURLでこのサーバーを運用しています。

https://mcp.aivikings.ai/mcp

セットアップガイド、全ツールのリファレンス、料金については、こちらをご覧ください：aivikings.ai/docs/mcp

接続

AiVikings.aiのアカウントが必要です。app.aivikings.aiで作成してください。

このサーバーはOAuthを使用します。初回使用時に、クライアントからAiVikings.aiのページが開き、接続を承認します。現在、そのページではダッシュボードからAPIトークンを貼り付ける必要があります。

Claude Code

claude mcp add --transport http aivikings https://mcp.aivikings.ai/mcp

Claude（Web版およびデスクトップ版）

URL https://mcp.aivikings.ai/mcp を指定して、カスタムコネクターを追加します。手順はこちらをご覧ください：Claudeのセットアップ。

ChatGPT

URL https://mcp.aivikings.ai/mcp とOAuth認証を使用して、コネクターを追加します。手順はこちらをご覧ください：ChatGPTのセットアップ。

Cursor

~/.cursor/mcp.jsonに追加します：

{
  "mcpServers": {
    "aivikings": {
      "url": "https://mcp.aivikings.ai/mcp"
    }
  }
}

VS Code

.vscode/mcp.jsonに追加します：

{
  "servers": {
    "aivikings": {
      "type": "http",
      "url": "https://mcp.aivikings.ai/mcp"
    }
  }
}

Clineなどのエージェント

MCPサーバーを自動でインストールするエージェントは、llms-install.mdを参照してください。

無人エージェント（LangChain、CrewAI、スクリプト）

ブラウザーを使わないエージェントはOAuthを完了できません。代わりに、AiVikings.aiのAPIキーをベアラートークンとして送信してください：

{
  "mcpServers": {
    "aivikings": {
      "type": "streamableHttp",
      "url": "https://mcp.aivikings.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AIVIKINGS_API_KEY"
      }
    }
  }
}

オプションのX-Agent-IdおよびX-Agent-Nameヘッダーを使うと、ドメイン監査ログでエージェントの操作を識別できます。

試してみる

接続したら、アシスタントに次のように尋ねてみてください：

• 「cartandcup.comは取得可能ですか？登録と更新にはいくらかかりますか？」
• 「気象分析プロジェクトの名前を20個考えて、空いている.comおよび.ioドメインを調べてください。」
• 「デフォルトの連絡先を使って、nightowlanalytics.comを1年間登録してください。」
• 「nightowlanalytics.comのルートを203.0.113.10に向けて、www用のCNAMEを追加してください。」
• 「自分のドメインと、それぞれのステータスおよび有効期限を表示してください。」

ツール

グループ	ツール
検索と料金	check_domain_availability, check_single_domain_availability, get_domain_pricing
登録（前払い残高を使用）	register_domain, renew_domain, domain_transfer
ドメイン管理	get_domain_status, list_domains, update_nameservers, lock_domain, unlock_domain, get_transfer_auth_code, regenerate_transfer_auth_code, get_domain_audit_log
DNS	list_dns_records, add_dns_record, configure_dns_record, update_dns_record, delete_dns_record
連絡先	create_contact, get_contact, list_contacts, list_domain_registration_contacts, assign_domain_registration_contact_roles, remove_domain_registration_contact_roles, update_registrant_contact, list_contact_countries, list_contact_states
アカウント	get_current_user, get_prepaid_balance, get_customer

詳細な説明とパラメーターについては、ツールリファレンスをご覧ください。

エージェント向けに設計

• プリペイド残高。 登録、更新、移管の料金は、プリペイドの USD または EUR 残高から支払われます。ツール呼び出しによってカードに請求されることはありません。
• プレミアムドメインには承認が必要です。 プレミアム価格のドメインは、ユーザーが提示価格を承認した後、エージェントが allow_premium=true を渡した場合にのみ登録されます。
• 安全性の注釈。 すべてのツールに読み取り専用または書き込みの区分が付けられ、破壊的なツール（delete_dns_record など）にはフラグが付けられているため、クライアントは実行前に確認できます。
• 監査ログ。 ドメインへのすべての変更が記録され、get_domain_audit_log で読み取ることができます。
• 純粋なレジストラー。 購入フローでホスティングやメールの追加販売はありません。

プライバシーとセキュリティ

このサーバーは薄いアダプターです。各リクエストには独自の OAuth トークンまたは API キーが含まれ、AiVikings.ai バックエンドによって検証された後、各ツール呼び出しとともに転送されます。アダプターは認証情報を保存せず、特権的なフォールバックトークンもありません。バックエンド内部のエラー詳細がクライアントに返されることはありません。

• プライバシーポリシー：aivikings.ai/legal/privacy
• 脆弱性の報告：SECURITY.md を参照してください

サポート

• 質問やアイデア：GitHub Discussions
• バグ：GitHub Issues
• メール：[email protected]

---

アダプターのセルフホスト

ほとんどのユーザーは、上記のホスト型サーバーに接続してください。このセクションでは、AiVikings.ai バックエンドの前段でアダプターを自分で実行する方法を説明します。

このアダプターは、AiVikings.ai レジストラー REST API 上に構築された、パブリックな Streamable HTTP MCP レイヤーです。ツールのパラメーターのスキーマ、説明、安全性の注釈はそのまま維持され、HTTP 経由でバックエンドを呼び出します。ビジネスロジック、認証、顧客の分離、スコープ、プロバイダーへのアクセス、監査情報の永続化はバックエンドが担います。

このリポジトリには、レジストラーバックエンド、データベースモデル、プロバイダーアダプター、フロントエンドのアセット、内部運用手順書、本番環境用ファイルは含まれていません。いずれのプライベートリポジトリにもアクセスせずに、インストールとビルドを行えます。

ローカルで実行

Python 3.12 以降と、/v1/mcp を公開する稼働中の AiVikings.ai バックエンドが必要です。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
cp .env.example .env
# Configure AIVIKINGS_API_BASE_URL to reach the backend.
aivikings-mcp

エンドポイントは http://127.0.0.1:8081/mcp です。クライアントは独自の AiVikings.ai ベアラー API キーまたは OAuth アクセストークンを送信します。アダプターはバックエンドを通じて検証し、各ツール呼び出しとともに転送します。特権的なフォールバックトークンはありません。トークンの失効と顧客／スコープの確認は、引き続きバックエンドが正しく処理します。匿名での initialize、tools/list、ping による検出は引き続き利用できます。

GET /healthz はローカルプロセスのヘルスチェックであり、上流の準備状態を確認するものではありません。/.well-known/oauth-protected-resource は、パブリックバックエンドを OAuth 認可サーバーとして通知します。AIVIKINGS_API_BASE_URL は内部 HTTP アドレスです。実際の OAuth クライアントで使用するには、AIVIKINGS_PUBLIC_API_BASE_URL と AIVIKINGS_MCP_URL が外部から到達可能である必要があります。OAuth の発行と署名に使うシークレットはバックエンドに保持されます。

Docker

docker compose up --build

スタンドアロンの Compose 設定では、host.docker.internal を使用して、バックエンドの公開ポート 8080 に接続します。デプロイ環境に合わせて、上流 URL と公開 URL を設定してください。先に .env.example をコピーする場合は、コンテナー内から到達可能なアドレスに、localhost の上流 URL を置き換えてください。プライベートなソースコードのチェックアウトはマウントされません。

テスト

pytest

テストではシミュレーション用の HTTP バックエンドを使用し、データベースなしで、検出、ベアラーチャレンジ、リクエストごとの ID、ツールスキーマ、エラーのサニタイズを検証します。バックエンドによる拒否は HTTP ステータスを含むツールエラーとして返されます。非公開の上流レスポンス本文が MCP クライアントに公開されることはありません。詳細はバックエンドのログを確認してください。

オプションの Claude デモクライアントは python -m pip install -e ".[demo]" でインストールできます。aivikings-demo-agent を実行する前に、クライアント側の ANTHROPIC_API_KEY と AIVIKINGS_MCP_API_KEY を設定してください。examples/ にあるサンプルトランスクリプトは過去のもので、参考例です。

ライセンス

MIT