mcphosting-cli 0.1.1 → 0.3.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 (6) hide show
  1. package/README.md +94 -196
  2. package/dist/index.cjs +1845 -384
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.js +1842 -381
  5. package/dist/index.js.map +1 -1
  6. package/package.json +13 -9
package/README.md CHANGED
@@ -1,260 +1,158 @@
1
1
  # MCPHosting CLI
2
2
 
3
- [![npm version](https://badge.fury.io/js/@mcphosting%2Fcli.svg)](https://www.npmjs.com/package/@mcphosting/cli)
4
- [![Downloads](https://img.shields.io/npm/dm/@mcphosting/cli.svg)](https://www.npmjs.com/package/@mcphosting/cli)
5
- [![GitHub stars](https://img.shields.io/github/stars/gorlomi-enzo/mcphosting-cli.svg)](https://github.com/gorlomi-enzo/mcphosting-cli)
3
+ [![npm version](https://badge.fury.io/js/mcphosting-cli.svg)](https://www.npmjs.com/package/mcphosting-cli)
4
+ [![Downloads](https://img.shields.io/npm/dm/mcphosting-cli.svg)](https://www.npmjs.com/package/mcphosting-cli)
6
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
6
 
8
- **Connect AI agents to MCP servers. Browse, install, and manage Model Context Protocol servers.**
9
-
10
- The easiest way to connect MCP servers to Claude Desktop, ChatGPT, Cursor, VS Code, and other AI clients. One command to rule them all.
7
+ **Deploy MCP servers in 30 seconds.** The easiest way to host, connect, and manage Model Context Protocol servers.
11
8
 
12
9
  ## ⚡ Quick Start
13
10
 
14
11
  ```bash
15
- # Install globally
16
- npm install -g @mcphosting/cli
12
+ npm install -g mcphosting-cli
17
13
 
18
- # Or run directly with npx
19
- npx @mcphosting/cli connect github
14
+ mcphosting login --github # Login with GitHub (recommended)
15
+ mcphosting deploy
16
+ # Done. Your MCP server is live. 🚀
20
17
  ```
21
18
 
22
- ## 🔗 How to Connect MCP Servers to AI Clients
23
-
24
- ### How to Connect MCP Servers to Claude Desktop
25
-
26
- Claude Desktop is the most popular way to use MCP servers. Here's how to connect any MCP server:
19
+ That's it. Three commands. Your MCP server is deployed and ready for Claude Desktop, Cursor, ChatGPT, and more.
27
20
 
28
- 1. **Install the CLI:**
29
- ```bash
30
- npm install -g @mcphosting/cli
31
- ```
21
+ ## 🚀 Deploy
32
22
 
33
- 2. **Connect an MCP server:**
34
- ```bash
35
- mcphost connect github
36
- ```
23
+ ### Deploy from current directory
37
24
 
38
- 3. **Restart Claude Desktop** to load the new MCP server
25
+ ```bash
26
+ cd my-mcp-server
27
+ mcphosting deploy
28
+ ```
39
29
 
40
- The CLI automatically detects your Claude Desktop installation and updates the `claude_desktop_config.json` file with the MCP server configuration.
30
+ Auto-detects your MCP server (looks for `@modelcontextprotocol/sdk` in package.json) and deploys it.
41
31
 
42
- **Manual Claude Desktop Setup:**
43
- If you prefer manual setup, edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
32
+ ### Deploy from GitHub
44
33
 
45
- ```json
46
- {
47
- "mcpServers": {
48
- "github": {
49
- "command": "npx",
50
- "args": ["-y", "@mcphosting/cli", "proxy", "https://github.mcphost.dev"],
51
- "env": {}
52
- }
53
- }
54
- }
34
+ ```bash
35
+ mcphosting deploy --github https://github.com/user/my-mcp-server
55
36
  ```
56
37
 
57
- ### How to Connect MCP Servers to ChatGPT
58
-
59
- ChatGPT Plus users can connect MCP servers through the web interface:
38
+ ### Deploy with options
60
39
 
61
- 1. **Get the MCP server URL:**
62
- ```bash
63
- mcphost info github # Shows the server URL
64
- ```
65
-
66
- 2. **Add to ChatGPT:**
67
- - Open ChatGPT in your browser
68
- - Go to Settings → Apps → Connect an app
69
- - Enter the MCP server URL (e.g., `https://github.mcphost.dev`)
70
- - Follow the authorization prompts
40
+ ```bash
41
+ mcphosting deploy --name "My MCP" --auth api_key
42
+ mcphosting deploy --api-url https://my-existing-mcp.com/api
43
+ ```
71
44
 
72
- 3. **Start using MCP tools** in your ChatGPT conversations
45
+ ## 🔗 Connect
73
46
 
74
- ### How to Connect MCP Servers to Cursor
47
+ Connect any MCP server to your AI clients with one command:
75
48
 
76
- Cursor IDE supports MCP servers through configuration files:
49
+ ```bash
50
+ mcphosting connect github # Connect GitHub MCP
51
+ mcphosting connect notion # Connect Notion MCP
52
+ mcphosting connect https://my.mcp # Connect custom server
77
53
 
78
- 1. **Auto-connect with CLI:**
79
- ```bash
80
- mcphost connect notion --client cursor
81
- ```
54
+ # Target specific client
55
+ mcphosting connect slack --client claude
56
+ mcphosting connect stripe --client cursor
57
+ ```
82
58
 
83
- 2. **Manual Cursor setup:**
84
- Create or edit `~/.cursor/mcp.json`:
85
- ```json
86
- {
87
- "mcpServers": {
88
- "notion": {
89
- "command": "npx",
90
- "args": ["-y", "@mcphosting/cli", "proxy", "https://notion.mcphost.dev"],
91
- "env": {}
92
- }
93
- }
94
- }
95
- ```
59
+ Auto-detects Claude Desktop, Cursor, VS Code, and OpenClaw — configures all of them at once.
96
60
 
97
- 3. **Restart Cursor** to load the MCP server
61
+ ## 📦 All Commands
98
62
 
99
- ## 📦 Available Commands
63
+ ### Authentication
100
64
 
101
- ### Connection Management
102
65
  ```bash
103
- mcphost connect <url-or-slug> # Connect MCP server to all AI clients
104
- mcphost connect <url> --client claude # Connect only to Claude Desktop
105
- mcphost disconnect <slug> # Remove MCP connection
106
- mcphost list # List all connected MCP servers
66
+ mcphosting login # GitHub login (default, recommended)
67
+ mcphosting login --github # Explicit GitHub login
68
+ mcphosting login --email me@x.com # Email/password login
69
+ mcphosting login --token <token> # Direct token auth
70
+ mcphosting login --browser # Browser-based login
71
+ mcphosting logout # Log out
72
+ mcphosting whoami # Show current user
107
73
  ```
108
74
 
109
- ### Marketplace
110
- ```bash
111
- mcphost search <query> # Search MCP marketplace
112
- mcphost info <slug> # Get detailed MCP server info
113
- ```
75
+ ### Deployment & Management
114
76
 
115
- ### Migration
116
77
  ```bash
117
- mcphost import --from smithery # Import from Smithery CLI
78
+ mcphosting deploy # Deploy current directory
79
+ mcphosting deploy --github <url> # Deploy from GitHub
80
+ mcphosting list # List all servers
81
+ mcphosting status <slug> # Check server status
82
+ mcphosting logs <slug> # View server logs
83
+ mcphosting logs <slug> -n 100 # Last 100 log lines
118
84
  ```
119
85
 
120
- ### Authentication (Optional)
121
- ```bash
122
- mcphost login # Login to MCPHosting
123
- mcphost logout # Logout
124
- mcphost whoami # Show current user
125
- ```
86
+ ### Environment Variables
126
87
 
127
- ## 🌟 Featured MCP Servers
128
-
129
- | Server | Description | Tools | Connect |
130
- |--------|-------------|-------|---------|
131
- | **GitHub** | Access repositories, issues, PRs | `read_file`, `list_repos`, `create_issue` | `mcphost connect github` |
132
- | **Slack** | Send messages, manage workspaces | `send_message`, `list_channels` | `mcphost connect slack` |
133
- | **Notion** | Read/write pages and databases | `read_page`, `create_page`, `query_database` | `mcphost connect notion` |
134
- | **Stripe** | Payment and customer data | `get_customer`, `list_payments` | `mcphost connect stripe` |
135
- | **PostgreSQL** | Safe database queries | `query`, `describe_table`, `list_tables` | `mcphost connect postgres` |
136
-
137
- ## 🚀 MCPHosting CLI vs Smithery CLI
138
-
139
- | Feature | MCPHosting CLI | Smithery CLI |
140
- |---------|----------------|--------------|
141
- | **Auto-detection** | ✅ Detects Claude, Cursor, VS Code | ❌ Manual config |
142
- | **ChatGPT support** | ✅ Web setup instructions | ❌ Not supported |
143
- | **Migration** | ✅ `import --from smithery` | ❌ No migration |
144
- | **Marketplace** | ✅ Search & browse built-in | ❌ Limited discovery |
145
- | **Growth features** | ✅ Sharing prompts, GitHub stars | ❌ Basic CLI |
146
- | **Proxy mode** | ✅ Built-in STDIO proxy | ❌ External tools needed |
147
- | **Multiple clients** | ✅ Connect to all at once | ❌ One at a time |
148
-
149
- **Migration from Smithery:**
150
88
  ```bash
151
- mcphost import --from smithery
89
+ mcphosting env list <slug> # List env vars
90
+ mcphosting env set <slug> KEY=val # Set an env var
91
+ mcphosting env remove <slug> KEY # Remove an env var
152
92
  ```
153
93
 
154
- ## 🎯 Supported AI Clients
155
-
156
- | Client | Status | Auto-Detection | Config Location |
157
- |--------|--------|----------------|-----------------|
158
- | **Claude Desktop** | ✅ Full support | ✅ Automatic | `~/Library/Application Support/Claude/` |
159
- | **ChatGPT Plus** | ✅ Web setup | N/A | Web interface |
160
- | **Cursor** | ✅ Full support | ✅ Automatic | `~/.cursor/mcp.json` |
161
- | **VS Code** | ✅ Full support | ✅ Automatic | `.vscode/mcp.json` |
162
- | **OpenClaw** | ✅ Full support | ✅ Automatic | `~/.openclaw/mcp.json` |
94
+ ### API Keys
163
95
 
164
- ## 🔧 Examples
165
-
166
- **Connect GitHub MCP to all clients:**
167
96
  ```bash
168
- mcphost connect github
169
- # 🎉 Connected! Share with your team:
170
- # npx @mcphosting/cli connect github
171
- #
172
- # ⭐ Star us: https://github.com/gorlomi-enzo/mcphosting-cli
97
+ mcphosting keys list # List API keys
98
+ mcphosting keys create "Prod Key" # Create new key
99
+ mcphosting keys delete <id> # Delete a key
173
100
  ```
174
101
 
175
- **Connect custom MCP server:**
176
- ```bash
177
- mcphost connect https://my-custom-mcp.example.com
178
- ```
102
+ ### Marketplace
179
103
 
180
- **Search for MCP servers:**
181
104
  ```bash
182
- mcphost search "database"
183
- mcphost search "slack"
184
- mcphost info notion
105
+ mcphosting search github # Search marketplace
106
+ mcphosting info notion # Server details
107
+ mcphosting connect <slug> # Install to AI clients
185
108
  ```
186
109
 
187
- **Import from Smithery:**
188
- ```bash
189
- mcphost import --from smithery --dry-run # Preview what will be imported
190
- mcphost import --from smithery # Actually import
191
- ```
110
+ ### Connection Management
192
111
 
193
- **List connections:**
194
112
  ```bash
195
- mcphost list
196
- # 📋 Connected MCP Servers (3)
197
- #
198
- # Slug | URL | Clients | Added
199
- # github | https://github.mcphost.dev | claude, cursor | 12/1/2024
200
- # slack | https://slack.mcphost.dev | claude | 12/1/2024
201
- # notion | https://notion.mcphost.dev | claude, cursor | 12/1/2024
113
+ mcphosting connect <url-or-slug> # Connect MCP to AI clients
114
+ mcphosting disconnect <slug> # Remove connection
115
+ mcphosting list --local # Show local connections
202
116
  ```
203
117
 
204
- ## 🏗️ How It Works
118
+ ### Migration
205
119
 
206
- 1. **URL Resolution:** Slugs like `github` become `https://github.mcphost.dev`
207
- 2. **Client Detection:** Automatically finds Claude Desktop, Cursor, VS Code configs
208
- 3. **Config Update:** Adds MCP server entry to each client's config file
209
- 4. **Proxy Mode:** Uses `npx @mcphosting/cli proxy <url>` for STDIO communication
210
-
211
- **Config Format:**
212
- ```json
213
- {
214
- "mcpServers": {
215
- "github": {
216
- "command": "npx",
217
- "args": ["-y", "@mcphosting/cli", "proxy", "https://github.mcphost.dev"],
218
- "env": {}
219
- }
220
- }
221
- }
120
+ ```bash
121
+ mcphosting import --from smithery # Import from Smithery
222
122
  ```
223
123
 
224
- ## 🔒 Security & Privacy
225
-
226
- - **No data collection** during MCP proxying
227
- - **Open source** - audit the code yourself
228
- - **Local config** - your connections stored in `~/.mcphosting/`
229
- - **Optional auth** - marketplace features only
230
-
231
- ## 📚 Documentation
232
-
233
- - [Getting Started Guide](https://mcphosting.com/docs/getting-started)
234
- - [MCP Server Development](https://mcphosting.com/docs/development)
235
- - [API Reference](https://mcphosting.com/docs/api)
236
- - [Troubleshooting](https://mcphosting.com/docs/troubleshooting)
124
+ ## 🎯 Supported AI Clients
237
125
 
238
- ## 🤝 Contributing
126
+ | Client | Auto-Config | Location |
127
+ |--------|:-----------:|----------|
128
+ | Claude Desktop | ✅ | `~/Library/Application Support/Claude/` |
129
+ | Cursor | ✅ | `~/.cursor/mcp.json` |
130
+ | VS Code | ✅ | `.vscode/mcp.json` |
131
+ | OpenClaw | ✅ | `~/.openclaw/mcp.json` |
132
+ | ChatGPT | 📋 | Web setup instructions |
239
133
 
240
- We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).
134
+ ## 🏗️ How It Works
241
135
 
242
- 1. Fork the repository
243
- 2. Create a feature branch: `git checkout -b my-feature`
244
- 3. Commit changes: `git commit -am 'Add feature'`
245
- 4. Push to branch: `git push origin my-feature`
246
- 5. Submit a Pull Request
136
+ 1. **`mcphosting login`** — Authenticates with MCPHosting.com
137
+ 2. **`mcphosting deploy`** — Detects your MCP server, deploys to cloud
138
+ 3. **`mcphosting connect`** — Configures your AI clients to use the server
139
+ 4. **Proxy mode** — `npx mcphosting-cli proxy <url>` bridges STDIO ↔ HTTP
247
140
 
248
- ## 📄 License
141
+ Your deployed server gets a URL like `https://your-server.mcphost.dev` that works with any MCP client.
249
142
 
250
- MIT License - see [LICENSE](LICENSE) for details.
143
+ ## 🔒 Security
251
144
 
252
- ## 🌟 Star History
145
+ - Credentials stored locally in `~/.config/mcphosting/`
146
+ - No data collection during proxy
147
+ - Open source — audit the code
148
+ - Optional auth — marketplace browsing works without login
253
149
 
254
- [![Star History Chart](https://api.star-history.com/svg?repos=gorlomi-enzo/mcphosting-cli&type=Date)](https://star-history.com/#gorlomi-enzo/mcphosting-cli&Date)
150
+ ## 📚 Links
255
151
 
256
- ---
152
+ - [Documentation](https://mcphosting.com/docs)
153
+ - [Dashboard](https://mcphosting.com/dashboard)
154
+ - [GitHub](https://github.com/gorlomi-enzo/mcphosting-cli)
257
155
 
258
- **Made with ❤️ by [MCPHosting](https://mcphosting.com)**
156
+ ## License
259
157
 
260
- [⭐ Star us on GitHub](https://github.com/gorlomi-enzo/mcphosting-cli) • [🐦 Follow on Twitter](https://twitter.com/mcphosting) • [💬 Join Discord](https://discord.gg/mcphosting)
158
+ MIT