conoha-vps-mcp

---

🌟 概要

ConoHa VPS MCPは、ConoHa VPSの公開APIを日本語で操作できるオープンソースのMCPサーバーです。AIエージェント（Claude Code、Claude Desktop、GitHub Copilot、Clineなど）と連携し、自然言語でインフラ操作ができます。

⚠️ 注意: 本ソフトウェアは現在ベータ版です。機能や動作が予告なく変更される場合があります。本番環境での使用前には十分なテストを行ってください。このベータ版 ConoHa VPS MCP を使用することで、これらの条件に同意したものとみなされます。

✨ 主な特徴

特徴	説明
🇯🇵 日本語対応	ツール説明・エラーメッセージを含め、すべて日本語で操作可能
🤖 AI エージェント連携	Claude Code、Claude Desktop、GitHub Copilot、Cline など主要なAIエージェントに対応
🔧 包括的API	サーバー・ボリューム・イメージ・セキュリティグループ・オブジェクトストレージを管理
🐳 クロスプラットフォーム	Node.js / Docker で動作、Windows・Mac・Linuxに対応
🛡️ セキュリティ対策	OpenStack準拠のセキュリティ機能を搭載

❓ Model Context Protocol (MCP) とは

MCPは、AIエージェント（Claude Code、Claude Desktop、GitHub Copilot、Clineなど）が外部のサービスやツールと連携するためのプロトコルです。このMCPサーバーを導入すると、AIに日本語で指示するだけでConoHa VPSの操作ができるようになります。

🚀 クイックスタート

Claude Desktopで利用する場合

1. ReleasesよりダウンロードしたmcpbファイルをClaude Desktopに登録
2. Claude Desktopで環境変数を設定

詳しくは mcpb ファイルインストール版実行ガイド を参照してください。

Claude Codeで利用する場合（プラグイン）

Claude Codeのプラグインマーケットプレイスからインストールできます。MCPサーバーに加えて、操作をガイドするスキルも利用可能になります。

/plugin marketplace add https://github.com/gmo-internet/conoha_vps_mcp

詳しくは Claude Code プラグインインストール版実行ガイド を参照してください。

それ以外のAIエージェント (GitHub Copilot等) で利用する場合

1. Node.jsをローカル端末にインストール

2. 利用中のMCP対応のAIエージェントにConoHa VPS MCPの設定を記載し、MCPサーバーを起動

   設定（簡略版）

   {
     "ConoHa VPS MCP": {
       "command": "npm",
       "args": [
         "exec",
         "@gmo-internet/conoha-vps-mcp@latest"
       ],
       "env": {
         "OPENSTACK_TENANT_ID": "YOUR_OPENSTACK_TENANT_ID",
         "OPENSTACK_USER_ID": "YOUR_OPENSTACK_USER_ID",
         "OPENSTACK_PASSWORD": "YOUR_OPENSTACK_PASSWORD"
       }
     }
   }
   

Cursor	VS Code

詳しくは npm パッケージインストール版実行ガイド を参照してください。

🔧 その他の方法で利用する場合

• 📋 Node.js ローカルビルド版実行ガイド - ソースコードからビルドして実行
• 🐳 Docker ローカルビルド版実行ガイド - Dockerコンテナで実行

🆘 トラブルシューティング

• ❓ FAQ - よくある質問と解決方法

🎯 使用例

リソース管理

現在あるサーバーの一覧を表示してください。

現在あるサーバーを確認し、test-1という名前のサーバーを停止してください。

test-1という名前のサーバーにアタッチされているボリュームの詳細を表示してください。

サーバー作成

Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード：vG7#kLp9zX!q、
ネームタグ：test-1、セキュリティグループ：defaultとして作ってください。

スタートアップスクリプトを利用したサーバー作成

Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード：vG7#kLp9zX!q、
ネームタグ：test、セキュリティグループ：defaultに加えて、SSHが使えるように作ってください。
その際、VPS上でClaude Codeを利用できるようにしてください。

⚠️ 注意: パスワードセキュリティに関する重要な警告

• 上記のパスワードは例示用です。そのまま使わないでください
• 実際の運用では、十分に複雑なパスワードを生成してください
• サーバー作成後はすぐにパスワードを変更するか、パスワード認証を無効化してください