![ConoHa VPS Logo](assets/conoha_logo.svg) # ConoHa VPS Model Context Protocol (MCP) サーバー [![GitHub Stars](https://img.shields.io/github/stars/gmo-internet/conoha_vps_mcp?style=flat-square&logo=github)](https://github.com/gmo-internet/conoha_vps_mcp/stargazers) [![GitHub License](https://img.shields.io/github/license/gmo-internet/conoha_vps_mcp?style=flat-square)](LICENSE) [![GitHub Release](https://img.shields.io/github/v/release/gmo-internet/conoha_vps_mcp?style=flat-square)](https://github.com/gmo-internet/conoha_vps_mcp/releases) [![Node.js](https://img.shields.io/badge/Node.js-18+-green?style=flat-square&logo=node.js)](https://nodejs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-white?style=flat-square&logo=typescript)](https://www.typescriptlang.org/) [![Docker](https://img.shields.io/badge/Docker-white?style=flat-square&logo=docker)](https://www.docker.com/) [![OpenStack](https://img.shields.io/badge/OpenStack-API-red?style=flat-square&logo=openstack)](https://docs.openstack.org/) [🚀 クイックスタート](#-クイックスタート) • [📚 使用例](#-使用例) • [よくある質問（FAQ）](docs/FAQ.md)
--- > [!IMPORTANT] > **🧪 OSS版（ローカル）MCP は実験的機能です — リモート版 MCP（ https://api.conoha.jp/vps/mcp ）のご利用を推奨します** > > 本リポジトリで配布しているOSS版（ローカル）MCP / MCP Apps は **実験的機能** として提供しています。 > OSS版（ローカル）版は引き続きご利用いただけますが、ベータ版の扱いであり、機能や動作が予告なく変更される場合があります。 > 本番環境での使用前には十分なテストを行ってください。 > また、OSS版（ローカル）ConoHa VPS MCP を使用することで、これらの条件に同意したものとみなされます。 > > 👉 リモート版について: https://vps.conoha.jp/function/mcp/ ## 🌟 概要 ConoHa VPS MCPは、ConoHa VPSの[公開API](https://doc.conoha.jp/reference/api-vps3/)を日本語で操作できるオープンソースのMCPサーバーです。AIエージェント（Claude Code、Claude Desktop、GitHub Copilot、Clineなど）と連携し、自然言語でインフラ操作ができます。 ## ✨ 主な特徴 | 特徴 | 説明 | |------|------| | 🇯🇵 **日本語対応** | ツール説明・エラーメッセージを含め、すべて日本語で操作可能 | | 🤖 **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](https://github.com/gmo-internet/conoha_vps_mcp/releases/)よりダウンロードしたmcpbファイルをClaude Desktopに登録 2. Claude Desktopで環境変数を設定 詳しくは [mcpb ファイルインストール版実行ガイド](docs/mcpb-setup.md) を参照してください。 ### Claude Codeで利用する場合（プラグイン） Claude Codeのプラグインマーケットプレイスからインストールできます。MCPサーバーに加えて、操作をガイドするスキルも利用可能になります。 ``` /plugin marketplace add https://github.com/gmo-internet/conoha_vps_mcp ``` 詳しくは [Claude Code プラグインインストール版実行ガイド](docs/plugin-setup.md) を参照してください。 ### それ以外のAIエージェント (GitHub Copilot等) で利用する場合 1. Node.jsをローカル端末にインストール 2. 利用中のMCP対応のAIエージェントにConoHa VPS MCPの設定を記載し、MCPサーバーを起動
設定（簡略版） ```json { "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 | |:------:|:-------:| | [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/ja/install-mcp?name=ConoHa%20VPS%20MCP&config=eyJlbnYiOnsiT1BFTlNUQUNLX1RFTkFOVF9JRCI6IiIsIk9QRU5TVEFDS19VU0VSX0lEIjoiIiwiT1BFTlNUQUNLX1BBU1NXT1JEIjoiIn0sImNvbW1hbmQiOiJucG0gZXhlYyBAZ21vLWludGVybmV0L2Nvbm9oYS12cHMtbWNwQGxhdGVzdCJ9) | [![Install VS Code](https://img.shields.io/badge/Install-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ConoHa%20VPS%20MCP&config=%7B%22command%22%3A%22npm%22%2C%22args%22%3A%5B%22exec%22%2C%22%40gmo-internet%2Fconoha-vps-mcp%40latest%22%5D%2C%22env%22%3A%7B%22OPENSTACK_TENANT_ID%22%3A%22%22%2C%22OPENSTACK_USER_ID%22%3A%22%22%2C%22OPENSTACK_PASSWORD%22%3A%22%22%7D%2C%22type%22%3A%22stdio%22%7D) | 詳しくは [npm パッケージインストール版実行ガイド](docs/npm-setup.md) を参照してください。 ### 🔧 その他の方法で利用する場合 - 📋 [Node.js ローカルビルド版実行ガイド](docs/nodejs-setup.md) - ソースコードからビルドして実行 - 🐳 [Docker ローカルビルド版実行ガイド](docs/docker-setup.md) - Dockerコンテナで実行 🆘 トラブルシューティング - ❓ [FAQ](docs/FAQ.md) - よくある質問と解決方法 ## 🎯 使用例 ### リソース管理 ```txt 現在あるサーバーの一覧を表示してください。 ``` ```txt 現在あるサーバーを確認し、test-1という名前のサーバーを停止してください。 ``` ```txt test-1という名前のサーバーにアタッチされているボリュームの詳細を表示してください。 ``` ### サーバー作成 ```txt Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード：vG7#kLp9zX!q、 ネームタグ：test-1、セキュリティグループ：defaultとして作ってください。 ``` ### スタートアップスクリプトを利用したサーバー作成 ```txt Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード：vG7#kLp9zX!q、 ネームタグ：test、セキュリティグループ：defaultに加えて、SSHが使えるように作ってください。 その際、VPS上でClaude Codeを利用できるようにしてください。 ``` **⚠️ 注意: パスワードセキュリティに関する重要な警告** - 上記のパスワードは例示用です。**そのまま使わないでください** - 実際の運用では、十分に複雑なパスワードを生成してください - サーバー作成後はすぐにパスワードを変更するか、パスワード認証を無効化してください - SSHキー認証への切り替えを推奨します - AIエージェントとの会話履歴にパスワードが残る点にも注意してください ### セキュリティ設定 ```txt Webサーバー用のセキュリティグループをweb-server-secgroupという名前で新しく作成して、 HTTP（80番）とHTTPS（443番）のみを許可してください。 ``` ### オブジェクトストレージ ``` オブジェクトストレージの容量を200GBに設定をして、コンテナ名：mysite-dev、 オブジェクト名：index.html、アップロードファイル：path/to/fileでオブジェクトを作成してください。 ``` ## 📚 ドキュメント ### 対応プラットフォーム **💡 重要:** 今後のバージョンアップによってサポート対象外となる可能性があります。 #### MCPサーバー実行環境 - ✅ Node.js v20以上 - ✅ Docker - ✅ Linux / macOS / Windows #### AIエージェント統合 - ✅ [Claude Code](https://docs.anthropic.com/en/docs/claude-code) - ✅ [Claude Desktop](https://claude.ai/download) - ✅ [Cursor](https://cursor.com/ja/download) - ✅ [Cline (VS Code)](https://github.com/cline/cline) - ✅ [GitHub Copilot (VS Code)](https://docs.github.com/ja/copilot) - ✅ [Codex CLI](https://github.com/openai/codex) **📝 注記:** MCPに対応した他のAIエージェントでも利用できます。詳細は各AIエージェントのドキュメントを参照して下さい。 #### ConoHa環境 - ✅ ConoHa VPS v3.0 API ### MCPサーバーで対応している主な機能一覧 | カテゴリ | 主な対応機能 | |---------|-------------| | サーバー | 作成 / 削除 / 起動 / 停止 / リサイズ / コンソール接続 | | ボリューム | 作成 / 削除 / 更新 | | イメージ | 一覧取得 | | SSHキーペア | 作成 / 削除 | | セキュリティグループ | 作成 / 削除 / 更新 | | セキュリティグループルール | 作成 / 削除 | | オブジェクトストレージ | 作成 / 削除 / 更新 | 📄 ツールごとの全機能一覧は[こちら](docs/tool.md)を参照してください。 🌐 オブジェクトストレージで静的サイトを公開する MCP App の使い方は[MCP App: 静的ホスティング UI 利用ガイド](docs/mcp-app-storage.md)を参照してください。 > 💻 開発者向け: リポジトリを clone して `npm run preview:ui` を実行すると、ConoHa の認証情報なしにサンプルデータで MCP App UI をブラウザプレビューできます。 ## ⚠️ 注意事項 ### AIエージェントの利用料金 - AIエージェント（Claude等）の利用には別途費用がかかる場合があります - 利用中のAIエージェントの料金プランを事前に確認してください ### API利用 - 🔑 **認証**: ConoHa VPSの公開APIクレデンシャルが必要です - 💰 **課金**: MCP自体は無償ですが、VPS作成等の操作でConoHa VPSの料金が発生します - 🛠️ **サポート**: MCP利用はConoHaサポート対象外です ### 自動化の注意点 - 設定ミスで意図しない課金が発生することがあります - 自動化する前に設定内容とセキュリティを確認してください - 不安な場合はコントロールパネルから手動で操作してください ### セキュリティ - 🔐 APIクレデンシャルは安全に管理してください - 🚫 本番環境では自動化スクリプトを十分テストしてください - 📊 使用状況を定期的に確認してください 詳しくは[ConoHa APIご利用前の留意事項](https://doc.conoha.jp/reference/api-vps3/api-guideline-vps3/api-guideline-v3/)を確認してください。 ## 🤝 コントリビュート - 📝 [コントリビューションガイド](CONTRIBUTING.md) - 🤝 [行動規範](CODE_OF_CONDUCT.md) - 🔒 [セキュリティポリシー](SECURITY.md) バグ報告や機能要望は[GitHub Issues](https://github.com/gmo-internet/conoha_vps_mcp/issues)でお受けしています。 ## 📄 ライセンス このプロジェクトは[Apache License 2.0](LICENSE) の下で公開されています。 ## 🙏 謝辞 - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP仕様の開発 - [OpenStack](https://www.openstack.org/) - クラウドインフラ技術の基盤 ## 📞 サポート・コミュニティ - 🐛 **バグ報告・機能要望**: [GitHub Issues](https://github.com/gmo-internet/conoha_vps_mcp/issues) - 🌟 **Star**: 役に立ったら ⭐ をいただけると励みになります ## 🔗 関連リンク - [ConoHa 公式サイト](https://www.conoha.jp/) - [公開 API ドキュメント](https://doc.conoha.jp/reference/api-vps3/) - [Model Context Protocol 仕様](https://modelcontextprotocol.io/) ---
**Made by [GMO Internet](https://internet.gmo/)** [⬆️ トップに戻る](#conoha-vps-mcp-server)