ConoHa VPS MCP Server

日本語対応のConoHa VPS Model Context Protocol (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で利用する場合

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

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

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

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

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

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

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

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

利用中の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を利用できるようにしてください。

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

上記のパスワードは例示用です。そのまま使わないでください
実際の運用では、十分に複雑なパスワードを生成してください
サーバー作成後はすぐにパスワードを変更するか、パスワード認証を無効化してください
SSHキー認証への切り替えを推奨します
AIエージェントとの会話履歴にパスワードが残る点にも注意してください

セキュリティ設定

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エージェント統合

📝 注記: MCPに対応した他のAIエージェントでも利用できます。詳細は各AIエージェントのドキュメントを参照して下さい。

ConoHa環境

✅ ConoHa VPS v3.0 API

MCPサーバーで対応している主な機能一覧

カテゴリ	主な対応機能
サーバー	作成 / 削除 / 起動 / 停止 / リサイズ / コンソール接続
ボリューム	作成 / 削除 / 更新
イメージ	一覧取得
SSHキーペア	作成 / 削除
セキュリティグループ	作成 / 削除 / 更新
セキュリティグループルール	作成 / 削除
オブジェクトストレージ	作成 / 削除 / 更新

📄 ツールごとの全機能一覧はこちらを参照してください。

⚠️ 注意事項

AIエージェントの利用料金

AIエージェント（Claude等）の利用には別途費用がかかる場合があります
利用中のAIエージェントの料金プランを事前に確認してください

API利用

🔑 認証: ConoHa VPSの公開APIクレデンシャルが必要です
💰 課金: MCP自体は無償ですが、VPS作成等の操作でConoHa VPSの料金が発生します
🛠️ サポート: MCP利用はConoHaサポート対象外です

自動化の注意点

設定ミスで意図しない課金が発生することがあります
自動化する前に設定内容とセキュリティを確認してください
不安な場合はコントロールパネルから手動で操作してください

セキュリティ

🔐 APIクレデンシャルは安全に管理してください
🚫 本番環境では自動化スクリプトを十分テストしてください
📊 使用状況を定期的に確認してください

詳しくはConoHa APIご利用前の留意事項を確認してください。

🤝 コントリビュート

バグ報告や機能要望はGitHub Issuesでお受けしています。

📄 ライセンス

このプロジェクトはApache License 2.0 の下で公開されています。

🙏 謝辞

Model Context Protocol - MCP仕様の開発
OpenStack - クラウドインフラ技術の基盤

📞 サポート・コミュニティ

🐛 バグ報告・機能要望: GitHub Issues
🌟 Star: 役に立ったら ⭐ をいただけると励みになります

🔗 関連リンク

Made by GMO Internet

⬆️ トップに戻る

Name		Name	Last commit message	Last commit date
Latest commit History 505 Commits
.claude-plugin		.claude-plugin
.claude		.claude
.codex		.codex
.cursor		.cursor
.github		.github
.vscode		.vscode
assets		assets
docs		docs
harness		harness
scripts		scripts
skills		skills
src		src
.dependency-cruiser.cjs		.dependency-cruiser.cjs
.dockerignore		.dockerignore
.dxtignore		.dxtignore
.gitignore		.gitignore
.jscpd.json		.jscpd.json
.mcpbignore		.mcpbignore
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CODING_PATTERN.md		CODING_PATTERN.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
NOTICE		NOTICE
README.md		README.md
README_DEV.md		README_DEV.md
SECURITY.md		SECURITY.md
biome.json		biome.json
compose.yaml		compose.yaml
conoha_mcpb_icon.png		conoha_mcpb_icon.png
esbuild.config.js		esbuild.config.js
knip.json		knip.json
manifest.json		manifest.json
package-lock.json		package-lock.json
package.json		package.json
stryker.config.js		stryker.config.js
tsconfig.json		tsconfig.json
typedoc.json		typedoc.json
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation

ConoHa VPS MCP Server

🌟 概要

✨ 主な特徴

❓ Model Context Protocol (MCP) とは

🚀 クイックスタート

Claude Desktopで利用する場合

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

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

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

🎯 使用例

リソース管理

サーバー作成

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

セキュリティ設定

オブジェクトストレージ

📚 ドキュメント

対応プラットフォーム

MCPサーバー実行環境

AIエージェント統合

ConoHa環境

MCPサーバーで対応している主な機能一覧

⚠️ 注意事項

AIエージェントの利用料金

API利用

自動化の注意点

セキュリティ

🤝 コントリビュート

📄 ライセンス

🙏 謝辞

📞 サポート・コミュニティ

🔗 関連リンク

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 10

Contributors

Uh oh!

Languages