mcphosted 0.0.0 → 1.20260929.36

package/README.md

@@ -1,3 +1,54 @@
 # mcphosted
 
-Placeholder. The self-hosted MCP Hosted server is published here soon. See https://mcphosted.com
+Self-hosted MCP servers from [MCP Hosted](https://mcphosted.com). WeFact and Laravel Forge are available today. One command starts a provider's MCP server on your own machine, and your AI client talks to it over stdio. Your API key never leaves your computer.
+
+It needs Node.js 18 or newer and nothing else: the package ships one self-contained binary per platform (macOS and Linux, on x64 and arm64). Windows is not supported yet; use the hosted server at https://mcphosted.com there.
+
+## Use it
+
+Add it to the MCP config of your AI client (Cursor, Claude Desktop, VS Code):
+
+```json
+{
+    "mcpServers": {
+        "forge": {
+            "command": "npx",
+            "args": ["-y", "mcphosted", "forge"],
+            "env": {
+                "FORGE_API_KEY": "<your API token>",
+                "MCPHOSTED_LICENSE_KEY": "<your license key>"
+            }
+        }
+    }
+}
+```
+
+Or in Claude Code:
+
+```sh
+claude mcp add --transport stdio --scope user forge --env FORGE_API_KEY=<your API token> --env MCPHOSTED_LICENSE_KEY=<your license key> -- npx -y mcphosted forge
+```
+
+## Environment
+
+| Variable | What |
+|----------|------|
+| `WEFACT_API_KEY` | Your WeFact API key, for `mcphosted wefact` |
+| `FORGE_API_KEY` | Your Laravel Forge API token, for `mcphosted forge` |
+| `MCPHOSTED_LICENSE_KEY` | Your license key for that provider |
+
+## License key
+
+Every provider needs its own license, a one-time purchase. Buy one on the provider's setup page at [mcphosted.com](https://mcphosted.com), which also shows your keys, the exact setup and a prompt that lets your AI coding assistant do it for you. Without a valid key the server does not start and says why on stderr.
+
+## Pin a build
+
+A license key never expires, and it starts every build we publish in the year after you buy it. After that, newer builds refuse it, so pin the builds it covers. Every version carries the day it was built, as `1.YYYYMMDD.N`, so a range pins every build up to a day: when your updates run until 2027-09-28, ask for anything below 2027-09-29.
+
+```sh
+npx -y "mcphosted@<1.20270929.0" forge
+```
+
+The quotes keep the shell from reading `<` as a redirect. In an MCP config, put `"mcphosted@<1.20270929.0"` in place of `"mcphosted"` in `args`, with no extra quotes. npm then picks the newest build your license covers, and the server prints the exact range when it refuses your key. Or buy a new license for another year of updates.
+
+Rather not run anything yourself? The same servers are hosted at [mcphosted.com](https://mcphosted.com).

package/bin/mcphosted.js

@@ -1,3 +1,59 @@
 #!/usr/bin/env node
-console.error("mcphosted is not released yet. See https://mcphosted.com");
-process.exit(1);
+// Starts the mcphosted binary for this platform with the same arguments, for example `npx -y mcphosted forge`.
+// npm installs only the platform package that matches this machine, through optionalDependencies.
+// stdin and stdout are the MCP client's, so they are passed straight through.
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+const packages = {
+    'darwin arm64': 'mcphosted-darwin-arm64',
+    'darwin x64': 'mcphosted-darwin-x64',
+    'linux arm64': 'mcphosted-linux-arm64',
+    'linux x64': 'mcphosted-linux-x64',
+};
+
+const name = packages[`${process.platform} ${process.arch}`];
+
+if (!name) {
+    console.error(
+        `mcphosted does not run on ${process.platform} ${process.arch} yet. It runs on ${Object.keys(packages).join(', ')}. Use the hosted server at https://mcphosted.com instead.`,
+    );
+    process.exit(1);
+}
+
+let binary;
+
+try {
+    const manifest = createRequire(import.meta.url).resolve(`${name}/package.json`);
+    binary = join(dirname(manifest), 'bin', process.platform === 'win32' ? 'mcphosted.exe' : 'mcphosted');
+} catch {
+    console.error(`mcphosted could not find the ${name} package. Install it again without --omit=optional or --no-optional.`);
+    process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit', windowsHide: true });
+const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+
+for (const signal of signals) {
+    process.on(signal, () => child.kill(signal));
+}
+
+child.on('error', (error) => {
+    console.error(`mcphosted could not start ${binary}: ${error.message}`);
+    process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+    if (signal) {
+        for (const forwarded of signals) {
+            process.removeAllListeners(forwarded);
+        }
+
+        process.kill(process.pid, signal);
+
+        return;
+    }
+
+    process.exit(code ?? 1);
+});

package/package.json

@@ -1 +1,36 @@
-{"name":"mcphosted","version":"0.0.0","description":"Placeholder for the MCP Hosted self-hosted server. See https://mcphosted.com","license":"UNLICENSED","bin":{"mcphosted":"bin/mcphosted.js"}}
+{
+    "name": "mcphosted",
+    "version": "1.20260929.36",
+    "description": "Self-hosted MCP servers from MCP Hosted, such as WeFact and Laravel Forge, over stdio with nothing else to install.",
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "wefact",
+        "laravel-forge",
+        "forge",
+        "claude",
+        "cursor"
+    ],
+    "license": "UNLICENSED",
+    "homepage": "https://mcphosted.com",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/pixel-perfect-agency/mcphosted.git"
+    },
+    "type": "module",
+    "bin": {
+        "mcphosted": "bin/mcphosted.js"
+    },
+    "files": [
+        "bin"
+    ],
+    "engines": {
+        "node": ">=18"
+    },
+    "optionalDependencies": {
+        "mcphosted-darwin-arm64": "1.20260929.36",
+        "mcphosted-darwin-x64": "1.20260929.36",
+        "mcphosted-linux-x64": "1.20260929.36",
+        "mcphosted-linux-arm64": "1.20260929.36"
+    }
+}