@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.
- package/NOTICE +16 -10
- package/README.md +39 -35
- package/dist/index.js +171 -51
- 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.
|
|
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.
|
|
33
|
+
- zod-to-json-schema (3.25.1)
|
|
31
34
|
|
|
32
35
|
MIT Licensed:
|
|
33
|
-
- @
|
|
36
|
+
- @hono/node-server (1.19.11)
|
|
37
|
+
- @modelcontextprotocol/sdk (1.27.1)
|
|
34
38
|
- accepts (2.0.0)
|
|
35
|
-
- ajv (8.
|
|
39
|
+
- ajv (8.18.0)
|
|
36
40
|
- ajv-formats (3.0.1)
|
|
37
|
-
- body-parser (2.2.
|
|
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 (
|
|
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.
|
|
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.
|
|
98
|
-
- serve-static (2.2.
|
|
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.
|
|
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/)
|
|
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
|
-
| 🇯🇵
|
|
37
|
-
| 🤖 **AI
|
|
38
|
-
| 🔧 **包括的API** |
|
|
39
|
-
| 🐳 **クロスプラットフォーム** | Node.js
|
|
40
|
-
| 🛡️ **セキュリティ対策** | OpenStack
|
|
34
|
+
| 🇯🇵 **日本語対応** | ツール説明・エラーメッセージを含め、すべて日本語で操作可能 |
|
|
35
|
+
| 🤖 **AI エージェント連携** | GitHub Copilot、Claude、Cline など主要なAIエージェントに対応 |
|
|
36
|
+
| 🔧 **包括的API** | サーバー・ボリューム・イメージ・セキュリティグループ・オブジェクトストレージを管理 |
|
|
37
|
+
| 🐳 **クロスプラットフォーム** | Node.js / Docker で動作、Windows・Mac・Linuxに対応 |
|
|
38
|
+
| 🛡️ **セキュリティ対策** | OpenStack準拠のセキュリティ機能を搭載 |
|
|
41
39
|
|
|
42
40
|
## ❓ Model Context Protocol (MCP) とは
|
|
43
41
|
|
|
44
|
-
|
|
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
|
-
|
|
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
|
| [](https://cursor.com/ja/install-mcp?name=ConoHa%20VPS%20MCP&config=eyJlbnYiOnsiT1BFTlNUQUNLX1RFTkFOVF9JRCI6IiIsIk9QRU5TVEFDS19VU0VSX0lEIjoiIiwiT1BFTlNUQUNLX1BBU1NXT1JEIjoiIn0sImNvbW1hbmQiOiJucG0gZXhlYyBAZ21vLWludGVybmV0L2Nvbm9oYS12cHMtbWNwQGxhdGVzdCJ9) | [](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
|
-
|
|
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
|
|
186
|
-
-
|
|
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
|
-
|
|
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
|
|