mcphosting-cli 0.1.2 → 0.4.0

package/README.md

@@ -1,260 +1,12 @@
-# MCPHosting CLI
+# mcphosting-cli
 
-[![npm version](https://badge.fury.io/js/@mcphosting%2Fcli.svg)](https://www.npmjs.com/package/@mcphosting/cli)
-[![Downloads](https://img.shields.io/npm/dm/@mcphosting/cli.svg)](https://www.npmjs.com/package/@mcphosting/cli)
-[![GitHub stars](https://img.shields.io/github/stars/gorlomi-enzo/mcphosting-cli.svg)](https://github.com/gorlomi-enzo/mcphosting-cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+File tasks into your [MCPHosting.com](https://mcphosting.com) AI command center from the terminal, and link Claude Code / Cursor to your workspace via MCP.
 
-**Connect AI agents to MCP servers. Browse, install, and manage Model Context Protocol servers.**
-
-The easiest way to connect MCP servers to Claude Desktop, ChatGPT, Cursor, VS Code, and other AI clients. One command to rule them all.
-
-## ⚡ Quick Start
-
-```bash
-# Install globally
-npm install -g @mcphosting/cli
-
-# Or run directly with npx
-npx @mcphosting/cli connect github
-```
-
-## 🔗 How to Connect MCP Servers to AI Clients
-
-### How to Connect MCP Servers to Claude Desktop
-
-Claude Desktop is the most popular way to use MCP servers. Here's how to connect any MCP server:
-
-1. **Install the CLI:**
-   ```bash
-   npm install -g @mcphosting/cli
-   ```
-
-2. **Connect an MCP server:**
-   ```bash
-   mcphost connect github
-   ```
-
-3. **Restart Claude Desktop** to load the new MCP server
-
-The CLI automatically detects your Claude Desktop installation and updates the `claude_desktop_config.json` file with the MCP server configuration.
-
-**Manual Claude Desktop Setup:**
-If you prefer manual setup, edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@mcphosting/cli", "proxy", "https://github.mcphost.dev"],
-      "env": {}
-    }
-  }
-}
+```sh
+npx mcphosting-cli login                # paste an API key from Settings → API & Vault
+npx mcphosting-cli link                 # registers the MCPHosting MCP server with Claude Code
+npx mcphosting-cli task create "Fix pricing page copy"
+npx mcphosting-cli task list
 ```
 
-### How to Connect MCP Servers to ChatGPT
-
-ChatGPT Plus users can connect MCP servers through the web interface:
-
-1. **Get the MCP server URL:**
-   ```bash
-   mcphost info github  # Shows the server URL
-   ```
-
-2. **Add to ChatGPT:**
-   - Open ChatGPT in your browser
-   - Go to Settings → Apps → Connect an app
-   - Enter the MCP server URL (e.g., `https://github.mcphost.dev`)
-   - Follow the authorization prompts
-
-3. **Start using MCP tools** in your ChatGPT conversations
-
-### How to Connect MCP Servers to Cursor
-
-Cursor IDE supports MCP servers through configuration files:
-
-1. **Auto-connect with CLI:**
-   ```bash
-   mcphost connect notion --client cursor
-   ```
-
-2. **Manual Cursor setup:**
-   Create or edit `~/.cursor/mcp.json`:
-   ```json
-   {
-     "mcpServers": {
-       "notion": {
-         "command": "npx",
-         "args": ["-y", "@mcphosting/cli", "proxy", "https://notion.mcphost.dev"],
-         "env": {}
-       }
-     }
-   }
-   ```
-
-3. **Restart Cursor** to load the MCP server
-
-## 📦 Available Commands
-
-### Connection Management
-```bash
-mcphost connect <url-or-slug>           # Connect MCP server to all AI clients
-mcphost connect <url> --client claude   # Connect only to Claude Desktop
-mcphost disconnect <slug>               # Remove MCP connection
-mcphost list                           # List all connected MCP servers
-```
-
-### Marketplace
-```bash
-mcphost search <query>                 # Search MCP marketplace
-mcphost info <slug>                    # Get detailed MCP server info
-```
-
-### Migration
-```bash
-mcphost import --from smithery         # Import from Smithery CLI
-```
-
-### Authentication (Optional)
-```bash
-mcphost login                          # Login to MCPHosting
-mcphost logout                         # Logout
-mcphost whoami                         # Show current user
-```
-
-## 🌟 Featured MCP Servers
-
-| Server | Description | Tools | Connect |
-|--------|-------------|-------|---------|
-| **GitHub** | Access repositories, issues, PRs | `read_file`, `list_repos`, `create_issue` | `mcphost connect github` |
-| **Slack** | Send messages, manage workspaces | `send_message`, `list_channels` | `mcphost connect slack` |
-| **Notion** | Read/write pages and databases | `read_page`, `create_page`, `query_database` | `mcphost connect notion` |
-| **Stripe** | Payment and customer data | `get_customer`, `list_payments` | `mcphost connect stripe` |
-| **PostgreSQL** | Safe database queries | `query`, `describe_table`, `list_tables` | `mcphost connect postgres` |
-
-## 🚀 MCPHosting CLI vs Smithery CLI
-
-| Feature | MCPHosting CLI | Smithery CLI |
-|---------|----------------|--------------|
-| **Auto-detection** | ✅ Detects Claude, Cursor, VS Code | ❌ Manual config |
-| **ChatGPT support** | ✅ Web setup instructions | ❌ Not supported |
-| **Migration** | ✅ `import --from smithery` | ❌ No migration |
-| **Marketplace** | ✅ Search & browse built-in | ❌ Limited discovery |
-| **Growth features** | ✅ Sharing prompts, GitHub stars | ❌ Basic CLI |
-| **Proxy mode** | ✅ Built-in STDIO proxy | ❌ External tools needed |
-| **Multiple clients** | ✅ Connect to all at once | ❌ One at a time |
-
-**Migration from Smithery:**
-```bash
-mcphost import --from smithery
-```
-
-## 🎯 Supported AI Clients
-
-| Client | Status | Auto-Detection | Config Location |
-|--------|--------|----------------|-----------------|
-| **Claude Desktop** | ✅ Full support | ✅ Automatic | `~/Library/Application Support/Claude/` |
-| **ChatGPT Plus** | ✅ Web setup | N/A | Web interface |
-| **Cursor** | ✅ Full support | ✅ Automatic | `~/.cursor/mcp.json` |
-| **VS Code** | ✅ Full support | ✅ Automatic | `.vscode/mcp.json` |
-| **OpenClaw** | ✅ Full support | ✅ Automatic | `~/.openclaw/mcp.json` |
-
-## 🔧 Examples
-
-**Connect GitHub MCP to all clients:**
-```bash
-mcphost connect github
-# 🎉 Connected! Share with your team:
-# npx @mcphosting/cli connect github
-# 
-# ⭐ Star us: https://github.com/gorlomi-enzo/mcphosting-cli
-```
-
-**Connect custom MCP server:**
-```bash
-mcphost connect https://my-custom-mcp.example.com
-```
-
-**Search for MCP servers:**
-```bash
-mcphost search "database"
-mcphost search "slack"
-mcphost info notion
-```
-
-**Import from Smithery:**
-```bash
-mcphost import --from smithery --dry-run  # Preview what will be imported
-mcphost import --from smithery            # Actually import
-```
-
-**List connections:**
-```bash
-mcphost list
-# 📋 Connected MCP Servers (3)
-# 
-# Slug    | URL                          | Clients           | Added
-# github  | https://github.mcphost.dev   | claude, cursor    | 12/1/2024
-# slack   | https://slack.mcphost.dev    | claude            | 12/1/2024
-# notion  | https://notion.mcphost.dev   | claude, cursor    | 12/1/2024
-```
-
-## 🏗️ How It Works
-
-1. **URL Resolution:** Slugs like `github` become `https://github.mcphost.dev`
-2. **Client Detection:** Automatically finds Claude Desktop, Cursor, VS Code configs
-3. **Config Update:** Adds MCP server entry to each client's config file
-4. **Proxy Mode:** Uses `npx @mcphosting/cli proxy <url>` for STDIO communication
-
-**Config Format:**
-```json
-{
-  "mcpServers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@mcphosting/cli", "proxy", "https://github.mcphost.dev"],
-      "env": {}
-    }
-  }
-}
-```
-
-## 🔒 Security & Privacy
-
-- **No data collection** during MCP proxying
-- **Open source** - audit the code yourself
-- **Local config** - your connections stored in `~/.mcphosting/`
-- **Optional auth** - marketplace features only
-
-## 📚 Documentation
-
-- [Getting Started Guide](https://mcphosting.com/docs/getting-started)
-- [MCP Server Development](https://mcphosting.com/docs/development)
-- [API Reference](https://mcphosting.com/docs/api)
-- [Troubleshooting](https://mcphosting.com/docs/troubleshooting)
-
-## 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).
-
-1. Fork the repository
-2. Create a feature branch: `git checkout -b my-feature`
-3. Commit changes: `git commit -am 'Add feature'`
-4. Push to branch: `git push origin my-feature`
-5. Submit a Pull Request
-
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE) for details.
-
-## 🌟 Star History
-
-[![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)
-
----
-
-**Made with ❤️ by [MCPHosting](https://mcphosting.com)**
-
-[⭐ Star us on GitHub](https://github.com/gorlomi-enzo/mcphosting-cli) • [🐦 Follow on Twitter](https://twitter.com/mcphosting) • [💬 Join Discord](https://discord.gg/mcphosting)
+Once linked, your local AI tools can create tasks, post to threads, and write notes in your dashboard — and your dashboard agents pick the work up from there.

package/index.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+// MCPHosting CLI — file tasks and link local AI tools to your command center.
+import { execSync } from 'node:child_process'
+import { readFileSync, writeFileSync, existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { createInterface } from 'node:readline/promises'
+
+const CONFIG_PATH = join(homedir(), '.mcphosting.json')
+const DEFAULT_SITE = 'https://mcphosting.com'
+
+function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_PATH, 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+function saveConfig(config) {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2))
+}
+
+function requireAuth() {
+  const config = loadConfig()
+  if (!config.apiKey) {
+    console.error('Not logged in. Run: mcphosting-cli login')
+    process.exit(1)
+  }
+  return config
+}
+
+async function api(config, path, options = {}) {
+  const res = await fetch(`${config.siteUrl ?? DEFAULT_SITE}${path}`, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${config.apiKey}`,
+      'Content-Type': 'application/json',
+      ...options.headers,
+    },
+  })
+  if (!res.ok) {
+    console.error(`API error ${res.status}: ${await res.text()}`)
+    process.exit(1)
+  }
+  return res.json()
+}
+
+const [, , command, ...args] = process.argv
+
+switch (command) {
+  case 'login': {
+    const rl = createInterface({ input: process.stdin, output: process.stdout })
+    const apiKey = (await rl.question('Paste your MCPHosting API key (mcph_...): ')).trim()
+    const siteUrl =
+      (await rl.question(`Site URL [${DEFAULT_SITE}]: `)).trim() || DEFAULT_SITE
+    rl.close()
+    if (!apiKey.startsWith('mcph_')) {
+      console.error('That does not look like an MCPHosting key (expected mcph_...).')
+      process.exit(1)
+    }
+    saveConfig({ apiKey, siteUrl })
+    const config = loadConfig()
+    await api(config, '/api/v1/tasks?status=all') // verify
+    console.log(`Logged in. Config saved to ${CONFIG_PATH}`)
+    break
+  }
+
+  case 'link': {
+    const config = requireAuth()
+    const mcpUrl = `${config.siteUrl ?? DEFAULT_SITE}/api/mcp/mcp`
+    const target = args[0] ?? 'claude'
+    if (target === 'claude') {
+      try {
+        execSync(
+          `claude mcp add mcphosting --transport http "${mcpUrl}" -H "Authorization: Bearer ${config.apiKey}"`,
+          { stdio: 'inherit' },
+        )
+        console.log('Linked: Claude Code can now file tasks into your MCPHosting dashboard.')
+      } catch {
+        console.error('Failed to run the claude CLI — is Claude Code installed?')
+        process.exit(1)
+      }
+    } else {
+      // Print a generic MCP config snippet (Cursor and other clients).
+      console.log('Add this MCP server to your client config:\n')
+      console.log(
+        JSON.stringify(
+          {
+            mcpServers: {
+              mcphosting: {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${config.apiKey}` },
+              },
+            },
+          },
+          null,
+          2,
+        ),
+      )
+    }
+    break
+  }
+
+  case 'task': {
+    const config = requireAuth()
+    const sub = args[0]
+    if (sub === 'create') {
+      const title = args.slice(1).join(' ')
+      if (!title) {
+        console.error('Usage: mcphosting-cli task create <title>')
+        process.exit(1)
+      }
+      const result = await api(config, '/api/v1/tasks', {
+        method: 'POST',
+        body: JSON.stringify({ title }),
+      })
+      console.log(`Task created: ${result.task_id}`)
+    } else if (sub === 'list' || !sub) {
+      const result = await api(config, '/api/v1/tasks')
+      for (const t of result.tasks) {
+        console.log(`[${t.status.padEnd(12)}] ${t.dept.padEnd(10)} ${t.title}`)
+      }
+      if (result.tasks.length === 0) console.log('No open tasks.')
+    } else {
+      console.error('Usage: mcphosting-cli task [create <title> | list]')
+      process.exit(1)
+    }
+    break
+  }
+
+  case 'status': {
+    const config = requireAuth()
+    const result = await api(config, '/api/v1/tasks')
+    const byStatus = {}
+    for (const t of result.tasks) byStatus[t.status] = (byStatus[t.status] ?? 0) + 1
+    console.log(`Workspace tasks: ${result.tasks.length} open`)
+    for (const [status, count] of Object.entries(byStatus)) console.log(`  ${status}: ${count}`)
+    break
+  }
+
+  default:
+    console.log(`MCPHosting CLI
+
+Usage:
+  mcphosting-cli login                 Save your API key (Settings -> API & Vault)
+  mcphosting-cli link [claude|config]  Register the MCPHosting MCP server with Claude Code
+  mcphosting-cli task create <title>   File a task into your dashboard
+  mcphosting-cli task list             List open tasks
+  mcphosting-cli status                Task counts by status`)
+}

package/package.json

@@ -1,61 +1,28 @@
 {
   "name": "mcphosting-cli",
-  "version": "0.1.2",
-  "description": "Connect AI agents to MCP servers. Browse, install, and manage Model Context Protocol servers.",
+  "version": "0.4.0",
+  "description": "CLI for MCPHosting.com \u2014 file tasks, link Claude Code/Cursor to your AI command center",
   "bin": {
-    "mcphost": "dist/index.js"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
+    "mcphosting-cli": "./index.js"
   },
   "type": "module",
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "node dist/index.js --help"
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gorlomi-enzo/mcphosting.com.git",
+    "directory": "cli"
   },
   "keywords": [
     "mcp",
     "model-context-protocol",
-    "claude",
-    "chatgpt",
-    "cursor",
     "ai-agents",
-    "mcp-server",
-    "mcp-hosting",
-    "smithery",
-    "github-mcp",
-    "slack-mcp",
-    "notion-mcp",
-    "stripe-mcp",
-    "mcp-marketplace",
-    "ai-tools",
-    "llm-tools"
+    "claude"
   ],
-  "author": "MCPHosting",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "conf": "^12.0.0",
-    "open": "^10.0.0",
-    "ora": "^8.0.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
-  },
   "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
+    "index.js",
+    "README.md"
   ]
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 MCPHosting / Gorlomi Ventures LLC
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.