@gmo-internet/conoha-vps-mcp 0.4.2 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/NOTICE +16 -10
  2. package/README.md +39 -35
  3. package/dist/index.js +171 -51
  4. package/package.json +24 -10
package/NOTICE CHANGED
@@ -16,9 +16,12 @@ limitations under the License.
16
16
  This product includes software developed by third parties:
17
17
 
18
18
 
19
+ BSD-2-Clause Licensed:
20
+ - json-schema-typed (8.0.2)
21
+
19
22
  BSD-3-Clause Licensed:
20
23
  - fast-uri (3.1.0)
21
- - qs (6.14.0)
24
+ - qs (6.15.0)
22
25
 
23
26
  ISC Licensed:
24
27
  - inherits (2.0.4)
@@ -27,14 +30,15 @@ ISC Licensed:
27
30
  - setprototypeof (1.2.0)
28
31
  - which (2.0.2)
29
32
  - wrappy (1.0.2)
30
- - zod-to-json-schema (3.25.0)
33
+ - zod-to-json-schema (3.25.1)
31
34
 
32
35
  MIT Licensed:
33
- - @modelcontextprotocol/sdk (1.24.3)
36
+ - @hono/node-server (1.19.11)
37
+ - @modelcontextprotocol/sdk (1.27.1)
34
38
  - accepts (2.0.0)
35
- - ajv (8.17.1)
39
+ - ajv (8.18.0)
36
40
  - ajv-formats (3.0.1)
37
- - body-parser (2.2.1)
41
+ - body-parser (2.2.2)
38
42
  - bytes (3.1.2)
39
43
  - call-bind-apply-helpers (1.0.2)
40
44
  - call-bound (1.0.4)
@@ -57,7 +61,7 @@ MIT Licensed:
57
61
  - eventsource (3.0.7)
58
62
  - eventsource-parser (3.0.6)
59
63
  - express (5.2.1)
60
- - express-rate-limit (7.5.1)
64
+ - express-rate-limit (8.3.0)
61
65
  - fast-deep-equal (3.1.3)
62
66
  - finalhandler (2.1.1)
63
67
  - forwarded (0.2.0)
@@ -68,8 +72,10 @@ MIT Licensed:
68
72
  - gopd (1.2.0)
69
73
  - has-symbols (1.1.0)
70
74
  - hasown (2.0.2)
75
+ - hono (4.12.5)
71
76
  - http-errors (2.0.1)
72
- - iconv-lite (0.7.0)
77
+ - iconv-lite (0.7.2)
78
+ - ip-address (10.1.0)
73
79
  - ipaddr.js (1.9.1)
74
80
  - is-promise (4.0.0)
75
81
  - jose (6.1.3)
@@ -94,8 +100,8 @@ MIT Licensed:
94
100
  - require-from-string (2.0.2)
95
101
  - router (2.2.0)
96
102
  - safer-buffer (2.1.2)
97
- - send (1.2.0)
98
- - serve-static (2.2.0)
103
+ - send (1.2.1)
104
+ - serve-static (2.2.1)
99
105
  - shebang-command (2.0.0)
100
106
  - shebang-regex (3.0.0)
101
107
  - side-channel (1.1.0)
@@ -107,6 +113,6 @@ MIT Licensed:
107
113
  - type-is (2.0.1)
108
114
  - unpipe (1.0.0)
109
115
  - vary (1.1.2)
110
- - zod (4.1.13)
116
+ - zod (4.3.6)
111
117
 
112
118
  For the full license text of these dependencies, please refer to their respective repositories or the node_modules directory.
package/README.md CHANGED
@@ -23,9 +23,7 @@
23
23
 
24
24
  ## 🌟 概要
25
25
 
26
- ConoHa VPS MCPは、ConoHa VPSの[公開API](https://doc.conoha.jp/reference/api-vps3/)を**日本語**で簡単に操作できるオープンソースの**Model Context Protocol (MCP) サーバー**です。
27
-
28
- Claude、GitHub Copilot、ClineなどのAIエージェントと連携することで、**自然言語によるインフラ操作**が可能になります。
26
+ ConoHa VPS MCPは、ConoHa VPSの[公開API](https://doc.conoha.jp/reference/api-vps3/)を日本語で操作できるオープンソースのMCPサーバーです。AIエージェント(Claude、GitHub Copilot、Clineなど)と連携し、自然言語でインフラ操作ができます。
29
27
 
30
28
  ⚠️ 注意: 本ソフトウェアは現在ベータ版です。機能や動作が予告なく変更される場合があります。本番環境での使用前には十分なテストを行ってください。このベータ版 ConoHa VPS MCP を使用することで、これらの条件に同意したものとみなされます。
31
29
 
@@ -33,16 +31,15 @@ Claude、GitHub Copilot、ClineなどのAIエージェントと連携するこ
33
31
 
34
32
  | 特徴 | 説明 |
35
33
  |------|------|
36
- | 🇯🇵 **完全日本語対応** | 完全日本語対応 「ConoHa VPS」のリソースを、日本語で直感的な操作が可能 |
37
- | 🤖 **AI エージェントとの連携** | GitHub CopilotClaude など、主要な AI エージェントと連携し、操作や構成の提案をサポート |
38
- | 🔧 **包括的API** | サーバー・ボリューム・イメージ・セキュリティグループ管理をサポート |
39
- | 🐳 **クロスプラットフォーム** | Node.js および Dockerでの実行環境を提供 |
40
- | 🛡️ **セキュリティ対策** | OpenStack 準拠のセキュリティ機能を装備 |
34
+ | 🇯🇵 **日本語対応** | ツール説明・エラーメッセージを含め、すべて日本語で操作可能 |
35
+ | 🤖 **AI エージェント連携** | GitHub CopilotClaude、Cline など主要なAIエージェントに対応 |
36
+ | 🔧 **包括的API** | サーバー・ボリューム・イメージ・セキュリティグループ・オブジェクトストレージを管理 |
37
+ | 🐳 **クロスプラットフォーム** | Node.js / Docker で動作、Windows・Mac・Linuxに対応 |
38
+ | 🛡️ **セキュリティ対策** | OpenStack準拠のセキュリティ機能を搭載 |
41
39
 
42
40
  ## ❓ Model Context Protocol (MCP) とは
43
41
 
44
- Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエージェントがインターネット上のサービスや様々なツールと連携するための共通化された仕組み(プロトコル)です。
45
- この仕組みにより、AIエージェントがあなたの代わりに、サーバーの操作やファイルの管理などの複雑な作業を簡単かつ自動で行えるようになります。
42
+ MCPは、AIエージェント(Claude、GitHub Copilot、Clineなど)が外部のサービスやツールと連携するためのプロトコルです。このMCPサーバーを導入すると、AIに日本語で指示するだけでConoHa VPSの操作ができるようになります。
46
43
 
47
44
  ## 🚀 クイックスタート
48
45
 
@@ -51,7 +48,7 @@ Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエー
51
48
  1. [Releases](https://github.com/gmo-internet/conoha_vps_mcp/releases/)よりダウンロードしたmcpbファイルをClaude Desktopに登録
52
49
  2. Claude Desktopで環境変数を設定
53
50
 
54
- 詳細な手順は 👉 [mcpb ファイルインストール版実行ガイド](docs/mcpb-setup.md) を参照してください。
51
+ 詳しくは [mcpb ファイルインストール版実行ガイド](docs/mcpb-setup.md) を参照してください。
55
52
 
56
53
  ### それ以外のAIエージェント (GitHub Copilot等) で利用する場合
57
54
 
@@ -82,7 +79,7 @@ Model Context Protocolとは、GitHub Copilot、Cline、ClaudeなどのAIエー
82
79
  |:------:|:-------:|
83
80
  | [![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) |
84
81
 
85
- 詳細な手順は 👉 [npm パッケージインストール版実行ガイド](docs/npm-setup.md) を参照してください。
82
+ 詳しくは [npm パッケージインストール版実行ガイド](docs/npm-setup.md) を参照してください。
86
83
 
87
84
  ### 🔧 その他の方法で利用する場合
88
85
 
@@ -126,11 +123,11 @@ Ubuntu 24.04でメモリ1GBのサーバーを、rootパスワード:vG7#kLp9zX
126
123
 
127
124
  **⚠️ 注意: パスワードセキュリティに関する重要な警告**
128
125
 
129
- - 上記のパスワード例は**絶対に実際に使用しないでください**(公開されているため)
130
- - 実際の運用では、十分に複雑で一意なパスワードを生成してください
131
- - サーバー作成後は、**直ちに**パスワードの変更、またはパスワード認証の無効化を行ってください
132
- - SSHキー認証への変更を強く推奨します
133
- - AIエージェントとの会話履歴にパスワードが残ることに注意してください
126
+ - 上記のパスワードは例示用です。**そのまま使わないでください**
127
+ - 実際の運用では、十分に複雑なパスワードを生成してください
128
+ - サーバー作成後はすぐにパスワードを変更するか、パスワード認証を無効化してください
129
+ - SSHキー認証への切り替えを推奨します
130
+ - AIエージェントとの会話履歴にパスワードが残る点にも注意してください
134
131
 
135
132
  ### セキュリティ設定
136
133
 
@@ -139,6 +136,13 @@ Webサーバー用のセキュリティグループをweb-server-secgroupとい
139
136
  HTTP(80番)とHTTPS(443番)のみを許可してください。
140
137
  ```
141
138
 
139
+ ### オブジェクトストレージ
140
+
141
+ ```
142
+ オブジェクトストレージの容量を200GBに設定をして、コンテナ名:mysite-dev、
143
+ オブジェクト名:index.html、アップロードファイル:path/to/fileでオブジェクトを作成してください。
144
+ ```
145
+
142
146
  ## 📚 ドキュメント
143
147
 
144
148
  ### 対応プラットフォーム
@@ -155,6 +159,7 @@ HTTP(80番)とHTTPS(443番)のみを許可してください。
155
159
 
156
160
  - ✅ [Cursor](https://cursor.com/ja/download)
157
161
  - ✅ [Claude Desktop](https://claude.ai/download)
162
+ - ✅ [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
158
163
  - ✅ [Cline (VS Code)](https://github.com/cline/cline)
159
164
  - ✅ [GitHub Copilot (VS Code)](https://docs.github.com/ja/copilot)
160
165
  - ✅ [Codex CLI](https://github.com/openai/codex)
@@ -175,40 +180,39 @@ HTTP(80番)とHTTPS(443番)のみを許可してください。
175
180
  | SSHキーペア | 作成 / 削除 |
176
181
  | セキュリティグループ | 作成 / 削除 / 更新 |
177
182
  | セキュリティグループルール | 作成 / 削除 |
183
+ | オブジェクトストレージ | 作成 / 削除 / 更新 |
178
184
 
179
185
  📄 ツールごとの全機能一覧は[こちら](docs/tool.md)を参照してください。
180
186
 
181
- ## ⚠️ 重要な注意事項
187
+ ## ⚠️ 注意事項
182
188
 
183
- ### AIエージェント利用について
189
+ ### AIエージェントの利用料金
184
190
 
185
- - Claude等、AIエージェントの利用には別途費用が発生する場合があります
186
- - 利用しているAIエージェントの料金プランや課金形態は十分確認してください
191
+ - AIエージェント(Claude等)の利用には別途費用がかかる場合があります
192
+ - 利用中のAIエージェントの料金プランを事前に確認してください
187
193
 
188
- ### API利用について
194
+ ### API利用
189
195
 
190
196
  - 🔑 **認証**: ConoHa VPSの公開APIクレデンシャルが必要です
191
- - 💰 **課金**: MCP自体は無償ですが、VPS作成等の操作により料金が発生する場合があります
197
+ - 💰 **課金**: MCP自体は無償ですが、VPS作成等の操作でConoHa VPSの料金が発生します
192
198
  - 🛠️ **サポート**: MCP利用はConoHaサポート対象外です
193
199
 
194
- ### 自動化利用について
200
+ ### 自動化の注意点
195
201
 
196
- - 設定ミスにより意図しない課金が発生する可能性があります
197
- - 自動化する際は設定の確認とセキュリティ対策を十分に行ってください
198
- - 不安な場合はコントロールパネルからの手動操作を推奨します
202
+ - 設定ミスで意図しない課金が発生することがあります
203
+ - 自動化する前に設定内容とセキュリティを確認してください
204
+ - 不安な場合はコントロールパネルから手動で操作してください
199
205
 
200
- ### セキュリティ考慮事項
206
+ ### セキュリティ
201
207
 
202
- - 🔐 APIクレデンシャルを安全に管理してください
203
- - 🚫 本番環境では自動化スクリプトの十分な検証を行ってください
204
- - 📊 使用状況を定期的に監視してください
208
+ - 🔐 APIクレデンシャルは安全に管理してください
209
+ - 🚫 本番環境では自動化スクリプトを十分テストしてください
210
+ - 📊 使用状況を定期的に確認してください
205
211
 
206
- 詳細は[ConoHa APIご利用前の留意事項](https://doc.conoha.jp/reference/api-vps3/api-guideline-vps3/api-guideline-v3/)をご確認ください。
212
+ 詳しくは[ConoHa APIご利用前の留意事項](https://doc.conoha.jp/reference/api-vps3/api-guideline-vps3/api-guideline-v3/)を確認してください。
207
213
 
208
214
  ## 🤝 コントリビュート
209
215
 
210
- 私たちはコミュニティからの貢献を歓迎します!
211
-
212
216
  - 📝 [コントリビューションガイド](CONTRIBUTING.md)
213
217
  - 🤝 [行動規範](CODE_OF_CONDUCT.md)
214
218
  - 🔒 [セキュリティポリシー](SECURITY.md)
@@ -227,7 +231,7 @@ HTTP(80番)とHTTPS(443番)のみを許可してください。
227
231
  ## 📞 サポート・コミュニティ
228
232
 
229
233
  - 🐛 **バグ報告・機能要望**: [GitHub Issues](https://github.com/gmo-internet/conoha_vps_mcp/issues)
230
- - 🌟 **Star**: このプロジェクトが役に立ったらをお願いします!
234
+ - 🌟 **Star**: 役に立ったらをいただけると励みになります
231
235
 
232
236
  ## 🔗 関連リンク
233
237