@gmo-internet/conoha-vps-mcp 0.5.0 → 0.5.2

package/NOTICE

@@ -21,7 +21,7 @@ BSD-2-Clause Licensed:
 
 BSD-3-Clause Licensed:
   - fast-uri (3.1.0)
-  - qs (6.14.1)
+  - qs (6.15.0)
 
 ISC Licensed:
   - inherits (2.0.4)
@@ -33,10 +33,10 @@ ISC Licensed:
   - zod-to-json-schema (3.25.1)
 
 MIT Licensed:
-  - @hono/node-server (1.19.9)
-  - @modelcontextprotocol/sdk (1.25.2)
+  - @hono/node-server (1.19.11)
+  - @modelcontextprotocol/sdk (1.27.1)
   - accepts (2.0.0)
-  - ajv (8.17.1)
+  - ajv (8.18.0)
   - ajv-formats (3.0.1)
   - body-parser (2.2.2)
   - bytes (3.1.2)
@@ -61,7 +61,7 @@ MIT Licensed:
   - eventsource (3.0.7)
   - eventsource-parser (3.0.6)
   - express (5.2.1)
-  - express-rate-limit (7.5.1)
+  - express-rate-limit (8.3.0)
   - fast-deep-equal (3.1.3)
   - finalhandler (2.1.1)
   - forwarded (0.2.0)
@@ -72,9 +72,10 @@ MIT Licensed:
   - gopd (1.2.0)
   - has-symbols (1.1.0)
   - hasown (2.0.2)
-  - hono (4.11.4)
+  - hono (4.12.5)
   - http-errors (2.0.1)
   - iconv-lite (0.7.2)
+  - ip-address (10.1.0)
   - ipaddr.js (1.9.1)
   - is-promise (4.0.0)
   - jose (6.1.3)
@@ -112,6 +113,6 @@ MIT Licensed:
   - type-is (2.0.1)
   - unpipe (1.0.0)
   - vary (1.1.2)
-  - zod (4.3.5)
+  - zod (4.3.6)
 
 For the full license text of these dependencies, please refer to their respective repositories or the node_modules directory.

package/README.md

@@ -23,9 +23,7 @@
 
 ## 🌟 概要
 
-ConoHa VPS MCPは、ConoHa VPSの[公開API](https://doc.conoha.jp/reference/api-vps3/)を**日本語**で簡単に操作できるオープンソースの**Model Context Protocol (MCP) サーバー**です。
-
-Claude、GitHub Copilot、ClineなどのAIエージェントと連携することで、**自然言語によるインフラ操作**が可能になります。
+ConoHa VPS MCPは、ConoHa VPSの[公開API](https://doc.conoha.jp/reference/api-vps3/)を日本語で操作できるオープンソースのMCPサーバーです。AIエージェント（Claude Code、Claude Desktop、GitHub Copilot、Clineなど）と連携し、自然言語でインフラ操作ができます。
 
 ⚠️ 注意: 本ソフトウェアは現在ベータ版です。機能や動作が予告なく変更される場合があります。本番環境での使用前には十分なテストを行ってください。このベータ版 ConoHa VPS MCP を使用することで、これらの条件に同意したものとみなされます。
 
@@ -33,16 +31,15 @@ Claude、GitHub Copilot、ClineなどのAIエージェントと連携するこ
 
 | 特徴 | 説明 |
 |------|------|
-| 🇯🇵 **完全日本語対応** | 完全日本語対応 「ConoHa VPS」のリソースを、日本語で直感的な操作が可能 |
-| 🤖 **AI エージェントとの連携** | GitHub Copilot や Claude など、主要な AI エージェントと連携し、操作や構成の提案をサポート |
-| 🔧 **包括的API** | サーバー・ボリューム・イメージ・セキュリティグループ・オブジェクトストレージ管理をサポート |
-| 🐳 **クロスプラットフォーム** | Node.js および Dockerでの実行環境を提供 |
-| 🛡️ **セキュリティ対策** | OpenStack 準拠のセキュリティ機能を装備 |
+| 🇯🇵 **日本語対応** | ツール説明・エラーメッセージを含め、すべて日本語で操作可能 |
+| 🤖 **AI エージェント連携** | Claude Code、Claude Desktop、GitHub Copilot、Cline など主要なAIエージェントに対応 |
+| 🔧 **包括的API** | サーバー・ボリューム・イメージ・セキュリティグループ・オブジェクトストレージを管理 |
+| 🐳 **クロスプラットフォーム** | Node.js / Docker で動作、Windows・Mac・Linuxに対応 |
+| 🛡️ **セキュリティ対策** | OpenStack準拠のセキュリティ機能を搭載 |
 
 ## ❓ Model Context Protocol (MCP) とは
 
-Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエージェントがインターネット上のサービスや様々なツールと連携するための共通化された仕組み（プロトコル）です。
-この仕組みにより、AIエージェントがあなたの代わりに、サーバーの操作やファイルの管理などの複雑な作業を簡単かつ自動で行えるようになります。
+MCPは、AIエージェント（Claude Code、Claude Desktop、GitHub Copilot、Clineなど）が外部のサービスやツールと連携するためのプロトコルです。このMCPサーバーを導入すると、AIに日本語で指示するだけでConoHa VPSの操作ができるようになります。
 
 ## 🚀 クイックスタート
 
@@ -51,7 +48,17 @@ Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエー
 1. [Releases](https://github.com/gmo-internet/conoha_vps_mcp/releases/)よりダウンロードしたmcpbファイルをClaude Desktopに登録
 2. Claude Desktopで環境変数を設定
 
-詳細な手順は 👉 [mcpb ファイルインストール版実行ガイド](docs/mcpb-setup.md) を参照してください。
+詳しくは [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等) で利用する場合
 
@@ -82,7 +89,7 @@ Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエー
   |:------:|:-------:|
   | [![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) を参照してください。
+詳しくは [npm パッケージインストール版実行ガイド](docs/npm-setup.md) を参照してください。
 
 ### 🔧 その他の方法で利用する場合
 
@@ -126,11 +133,11 @@ Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード：vG7#kLp9zX
 
 **⚠️ 注意: パスワードセキュリティに関する重要な警告**
 
-- 上記のパスワード例は**絶対に実際に使用しないでください**（公開されているため）
-- 実際の運用では、十分に複雑で一意なパスワードを生成してください
-- サーバー作成後は、**直ちに**パスワードの変更、またはパスワード認証の無効化を行ってください
-- SSHキー認証への変更を強く推奨します
-- AIエージェントとの会話履歴にパスワードが残ることに注意してください
+- 上記のパスワードは例示用です。**そのまま使わないでください**
+- 実際の運用では、十分に複雑なパスワードを生成してください
+- サーバー作成後はすぐにパスワードを変更するか、パスワード認証を無効化してください
+- SSHキー認証への切り替えを推奨します
+- AIエージェントとの会話履歴にパスワードが残る点にも注意してください
 
 ### セキュリティ設定
 
@@ -160,8 +167,9 @@ HTTP（80番）とHTTPS（443番）のみを許可してください。
 
 #### AIエージェント統合
 
-- ✅ [Cursor](https://cursor.com/ja/download)
+- ✅ [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)
@@ -186,37 +194,35 @@ HTTP（80番）とHTTPS（443番）のみを許可してください。
 
 📄 ツールごとの全機能一覧は[こちら](docs/tool.md)を参照してください。
 
-## ⚠️ 重要な注意事項
+## ⚠️ 注意事項
 
-### AIエージェント利用について
+### AIエージェントの利用料金
 
-- Claude等、AIエージェントの利用には別途費用が発生する場合があります
-- 利用しているAIエージェントの料金プランや課金形態は十分確認してください
+- AIエージェント（Claude等）の利用には別途費用がかかる場合があります
+- 利用中のAIエージェントの料金プランを事前に確認してください
 
-### API利用について
+### API利用
 
 - 🔑 **認証**: ConoHa VPSの公開APIクレデンシャルが必要です
-- 💰 **課金**: MCP自体は無償ですが、VPS作成等の操作により料金が発生する場合があります
+- 💰 **課金**: MCP自体は無償ですが、VPS作成等の操作でConoHa VPSの料金が発生します
 - 🛠️ **サポート**: MCP利用はConoHaサポート対象外です
 
-### 自動化利用について
+### 自動化の注意点
 
-- 設定ミスにより意図しない課金が発生する可能性があります
-- 自動化する際は設定の確認とセキュリティ対策を十分に行ってください
-- 不安な場合はコントロールパネルからの手動操作を推奨します
+- 設定ミスで意図しない課金が発生することがあります
+- 自動化する前に設定内容とセキュリティを確認してください
+- 不安な場合はコントロールパネルから手動で操作してください
 
-### セキュリティ考慮事項
+### セキュリティ
 
-- 🔐 APIクレデンシャルを安全に管理してください
-- 🚫 本番環境では自動化スクリプトの十分な検証を行ってください
-- 📊 使用状況を定期的に監視してください
+- 🔐 APIクレデンシャルは安全に管理してください
+- 🚫 本番環境では自動化スクリプトを十分テストしてください
+- 📊 使用状況を定期的に確認してください
 
-詳細は[ConoHa APIご利用前の留意事項](https://doc.conoha.jp/reference/api-vps3/api-guideline-vps3/api-guideline-v3/)をご確認ください。
+詳しくは[ConoHa APIご利用前の留意事項](https://doc.conoha.jp/reference/api-vps3/api-guideline-vps3/api-guideline-v3/)を確認してください。
 
 ## 🤝 コントリビュート
 
-私たちはコミュニティからの貢献を歓迎します！
-
 - 📝 [コントリビューションガイド](CONTRIBUTING.md)
 - 🤝 [行動規範](CODE_OF_CONDUCT.md)
 - 🔒 [セキュリティポリシー](SECURITY.md)
@@ -235,7 +241,7 @@ HTTP（80番）とHTTPS（443番）のみを許可してください。
 ## 📞 サポート・コミュニティ
 
 - 🐛 **バグ報告・機能要望**: [GitHub Issues](https://github.com/gmo-internet/conoha_vps_mcp/issues)
-- 🌟 **Star**: このプロジェクトが役に立ったら ⭐ をお願いします！
+- 🌟 **Star**: 役に立ったら ⭐ をいただけると励みになります
 
 ## 🔗 関連リンク