最終更新日: 2026年3月5日
概要
ConoHa VPS MCP Serverは、ConoHa VPSの公開APIを自然言語で操作できるオープンソースのModel Context Protocol(MCP)サーバーです。Claude、GitHub Copilot、ClineなどのAIエージェントと連携することで、サーバーの作成・管理・セキュリティ設定といったインフラ操作を会話形式で実行できます。
重要
本ソフトウェアは現在ベータ版です。機能や動作が予告なく変更される場合があります。本番環境での使用前には十分なテストを行ってください。
メモ
本MCPサーバーはConoHa VPS(Ver.3.0)のみ対応しています。利用にはConoHa VPSの公開APIクレデンシャルが必要です。VPSの作成等の操作により料金が発生する場合があります。また、MCPサーバーの利用はConoHaサポートの対象外です。
仕様
主要ソフトウェア
| ソフトウェア名 | バージョン | ライセンス | 用途 |
|---|---|---|---|
| ConoHa VPS MCP Server | 0.5.0 | Apache License 2.0 | ConoHa VPSをAIエージェントから操作するMCPサーバー |
| Node.js | v20以上 | MIT License | MCPサーバー実行環境 |
| Docker | Latest | Apache License 2.0 | コンテナ実行環境(オプション) |
対応機能
| カテゴリ | 主な対応機能 |
|---|---|
| サーバー | 作成 / 削除 / 起動 / 停止 / リサイズ / コンソール接続 |
| ボリューム | 作成 / 削除 / 更新 |
| イメージ | 一覧取得 |
| SSHキーペア | 作成 / 削除 |
| セキュリティグループ | 作成 / 削除 / 更新 |
| セキュリティグループルール | 作成 / 削除 |
| オブジェクトストレージ | 作成 / 削除 / 更新 |
対応プラットフォーム
| 種別 | 対応環境 |
|---|---|
| 実行環境 | Node.js v20以上 / Docker / Linux / macOS / Windows |
| AIエージェント | Claude Desktop / GitHub Copilot(VS Code)/ Cursor / Cline(VS Code)/ Codex CLI / その他MCP対応エージェント |
| ConoHa VPS | Ver.3.0 API |
利用手順
セキュリティ重要
APIクレデンシャル(テナントID・ユーザーID・パスワード)は安全に管理してください。AIエージェントとの会話履歴にパスワードが残ることに注意してください。また、VPS作成時のサンプルパスワードは絶対に実際の環境で使用しないでください。
Step 1: APIユーザーの準備
ConoHa VPSコントロールパネルからAPIユーザーを作成し、以下の情報を手元に用意してください。
- テナントID(
OPENSTACK_TENANT_ID) - ユーザーID(
OPENSTACK_USER_ID) - パスワード(
OPENSTACK_PASSWORD)
Step 2: 利用するセットアップ方法を選ぶ
利用するAIエージェントや環境に応じて、以下のいずれかの方法を選択してください。詳細手順は各ガイドを参照してください。
| 方法 | 対象 | 詳細ガイド |
|---|---|---|
| mcpbファイル版 | Claude Desktopで手軽に使いたい場合 | mcpb ファイルインストール版実行ガイド |
| npmパッケージ版 | GitHub Copilot・Cursor等で使いたい場合 | npm パッケージインストール版実行ガイド |
| Node.jsビルド版 | ソースコードからビルドして実行したい場合 | Node.js ローカルビルド版実行ガイド |
| Dockerビルド版 | Dockerコンテナで実行したい場合 | Docker ローカルビルド版実行ガイド |
Step 3: 動作確認
セットアップ完了後、AIエージェントに以下のように話しかけて動作を確認してください。
現在あるサーバーの一覧を表示してください。
サーバー一覧が返ってくれば正常に動作しています。利用可能なツールの全機能一覧はtool.mdを参照してください。
外部リンク
| サイト名 | URL | 説明 |
|---|---|---|
| GitHubリポジトリ | https://github.com/gmo-internet/conoha_vps_mcp | ソースコード・イシュートラッカー・各セットアップガイド |
| npmパッケージ | https://www.npmjs.com/package/@gmo-internet/conoha-vps-mcp | npmパッケージ情報 |
| ConoHa VPS API リファレンス | https://doc.conoha.jp/reference/api-vps3 | ConoHa VPS公開APIドキュメント |
| APIユーザー作成ガイド | https://doc.conoha.jp/reference/api-vps3/api-cp-vps3/cp-create_api_user-v3/ | コントロールパネルでのAPIユーザー作成手順 |
| Model Context Protocol 仕様 | https://modelcontextprotocol.io/ | MCP公式仕様・ドキュメント |
| よくある質問(FAQ) | https://github.com/gmo-internet/conoha_vps_mcp/blob/main/docs/FAQ.md | トラブルシューティング・よくある質問 |