ConoHa VPSをAIで操作！Docker版MCP構築手順

ConoHa VPSをAIエージェントから操作したいと考えていませんか？

ConoHa VPS MCPを使用すれば、GitHub CopilotやClaude Desktopから、自然言語でサーバーの起動・停止やリソース確認が可能になります。

この記事では、Dockerを使用してローカル環境で「ConoHa VPS MCP」をビルドし、各AIエージェントと連携させるための詳細な手順を解説します。

前提条件

Docker Desktop: インストール済みであること
Git: インストール済みであること
ConoHa API情報: APIユーザー名、パスワード、テナントID（ConoHaコントロールパネルから取得）

ステップ1：Dockerイメージのビルド

まず、GitHubからソースコードを取得し、Dockerイメージを作成します。

git clone https://github.com/gmo-internet/conoha_vps_mcp 
cd conoha_vps_mcp 
docker build -t conoha-vps-mcp .

ステップ2：AIエージェントとの連携設定

作成したDockerコンテナを、各種AIエージェントから呼び出せるように設定します。

GitHub Copilot (VSCode) の場合

VSCodeの設定ファイル（mcp.json）に以下の記述を追加します。

Windows (WSL2) の設定例：

Windows環境
{
  "inputs": [
    {
      "type": "promptString",
      "id": "openstack-tenant-id",
      "description": "OpenStack Tenant ID"
    },
    {
      "type": "promptString",
      "id": "openstack-user-id",
      "description": "OpenStack User ID"
    },
    {
      "type": "promptString",
      "id": "openstack-password",
      "description": "OpenStack Password",
      "password": true
    }
  ],
  "servers": {
    "ConoHa VPS MCP": {
      "command": "wsl",
      "cwd": "PATH_TO_DIRECTORY",
      "args": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENSTACK_TENANT_ID=${input:openstack-tenant-id}",
        "-e",
        "OPENSTACK_USER_ID=${input:openstack-user-id}",
        "-e",
        "OPENSTACK_PASSWORD=${input:openstack-password}",
        "conoha-vps-mcp"
      ]
    }
  }
}

Mac / Linux の設定例：

Mac/Linux環境
{
  "inputs": [
    {
      "type": "promptString",
      "id": "openstack-tenant-id",
      "description": "OpenStack Tenant ID"
    },
    {
      "type": "promptString",
      "id": "openstack-user-id",
      "description": "OpenStack User ID"
    },
    {
      "type": "promptString",
      "id": "openstack-password",
      "description": "OpenStack Password",
      "password": true
    }
  ],
  "servers": {
    "ConoHa VPS MCP": {
      "command": "docker",
      "cwd": "PATH_TO_DIRECTORY",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENSTACK_TENANT_ID=${input:openstack-tenant-id}",
        "-e",
        "OPENSTACK_USER_ID=${input:openstack-user-id}",
        "-e",
        "OPENSTACK_PASSWORD=${input:openstack-password}",
        "conoha-vps-mcp"
      ]
    }
  }
}

2. 設定値の確認

注意： APIパスワードはConoHaのログインパスワードとは異なります。APIユーザー作成時に設定した専用パスワードを使用してください。

環境変数の設定値：

OPENSTACK_TENANT_ID: テナントID
OPENSTACK_USER_ID: APIユーザーのユーザーID
OPENSTACK_PASSWORD: APIユーザーのパスワード

各値はConoHaコントロールパネルのAPI設定で確認できます。

Claude Desktop の場合

設定ファイル（claude_desktop_config.json）を開き、同様にDocker実行コマンドを記述します。

Windows環境

{
  "inputs": [
    {
      "type": "promptString",
      "id": "openstack-tenant-id",
      "description": "OpenStack Tenant ID"
    },
    {
      "type": "promptString",
      "id": "openstack-user-id",
      "description": "OpenStack User ID"
    },
    {
      "type": "promptString",
      "id": "openstack-password",
      "description": "OpenStack Password",
      "password": true
    }
  ],
  "servers": {
    "ConoHa VPS MCP": {
      "command": "wsl",
      "cwd": "PATH_TO_DIRECTORY",
      "args": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENSTACK_TENANT_ID=${input:openstack-tenant-id}",
        "-e",
        "OPENSTACK_USER_ID=${input:openstack-user-id}",
        "-e",
        "OPENSTACK_PASSWORD=${input:openstack-password}",
        "conoha-vps-mcp"
      ]
    }
  }
}

Mac/Linux環境

{
  "inputs": [
    {
      "type": "promptString",
      "id": "openstack-tenant-id",
      "description": "OpenStack Tenant ID"
    },
    {
      "type": "promptString",
      "id": "openstack-user-id",
      "description": "OpenStack User ID"
    },
    {
      "type": "promptString",
      "id": "openstack-password",
      "description": "OpenStack Password",
      "password": true
    }
  ],
  "servers": {
    "ConoHa VPS MCP": {
      "command": "docker",
      "cwd": "PATH_TO_DIRECTORY",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENSTACK_TENANT_ID=${input:openstack-tenant-id}",
        "-e",
        "OPENSTACK_USER_ID=${input:openstack-user-id}",
        "-e",
        "OPENSTACK_PASSWORD=${input:openstack-password}",
        "conoha-vps-mcp"
      ]
    }
  }
}