@caffeineai/mcp 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1 @@
+© Caffeine Labs AG. All rights reserved. Use is subject to the Caffeine AI [Terms of Use](https://caffeine.ai/terms-of-use)

package/README.md

@@ -0,0 +1,183 @@
+# @caffeineai/mcp
+
+MCP server that gives AI coding tools access to Caffeine projects.
+
+## Development Release
+
+This is a DEV release. It is published under the npm `dev` dist-tag and is subject to a rapid release cadence. Expect frequent updates while the CLI and MCP packages settle.
+
+Once installed and authenticated, your agent can list, clone, build, check, and preview Caffeine projects from inside your editor.
+
+## Prerequisites
+
+1. Node.js 20 or later.
+2. `@caffeineai/cli` signed in once. The MCP server reuses the CLI's OS credential-store login.
+
+```bash
+npm install -g @caffeineai/cli@dev
+caffeine auth login
+```
+
+## Pre-Warm The Package Cache
+
+The published package contains a native binary. `npx -y` caches it after the first download, but the first invocation often happens inside an MCP host process with a startup timeout. On a slow connection the host can mark the server as offline before the download finishes.
+
+Run this once in a terminal before relying on the server from any host:
+
+```bash
+npx -y @caffeineai/mcp@dev --version
+```
+
+After that, hosts on the same machine start the server from cache. Subsequent runs only re-download when a newer dev version has been published.
+
+## Install Into Your Host
+
+All snippets below use the stdio transport with `npx -y @caffeineai/mcp@dev` as the command.
+
+### Claude Code
+
+User-wide:
+
+```bash
+claude mcp add --transport stdio --scope user caffeine -- npx -y @caffeineai/mcp@dev
+```
+
+Project-wide, in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "caffeine": {
+      "command": "npx",
+      "args": ["-y", "@caffeineai/mcp@dev"]
+    }
+  }
+}
+```
+
+Inside Claude Code, type `/mcp` to see server status.
+
+### Cursor
+
+`.cursor/mcp.json` for a project, or `~/.cursor/mcp.json` globally:
+
+```json
+{
+  "mcpServers": {
+    "caffeine": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@caffeineai/mcp@dev"]
+    }
+  }
+}
+```
+
+Restart Cursor after adding the config.
+
+### VS Code With GitHub Copilot
+
+```bash
+code --add-mcp '{"name":"caffeine","command":"npx","args":["-y","@caffeineai/mcp@dev"]}'
+```
+
+Or `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "caffeine": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@caffeineai/mcp@dev"]
+    }
+  }
+}
+```
+
+Verify via the command palette: `MCP: List Servers`.
+
+### OpenAI Codex
+
+```bash
+codex mcp add caffeine -- npx -y @caffeineai/mcp@dev
+```
+
+Or `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.caffeine]
+command = "npx"
+args = ["-y", "@caffeineai/mcp@dev"]
+```
+
+Verify with `codex mcp list`.
+
+### Windsurf
+
+`~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "caffeine": {
+      "command": "npx",
+      "args": ["-y", "@caffeineai/mcp@dev"]
+    }
+  }
+}
+```
+
+Quit and reopen Windsurf after adding the config.
+
+## Available Tools
+
+| Tool | Description |
+| --- | --- |
+| `caffeine_auth_login` | Start a login flow |
+| `caffeine_auth_logout` | Log out and clear local credentials |
+| `caffeine_auth_status` | Check authentication status |
+| `caffeine_list_projects` | List your projects |
+| `caffeine_show_project` | Get project details |
+| `caffeine_create_project` | Create a project |
+| `caffeine_delete_project` | Delete a project |
+| `caffeine_clone_project` | Clone a project locally |
+| `caffeine_import_project` | Import a project from a .zip |
+| `caffeine_export_project` | Export the current project to a .zip |
+| `caffeine_build` | Build the project |
+| `caffeine_check` | Validate code and configuration |
+| `caffeine_preview` | Upload a built project as a draft |
+| `caffeine_doctor` | Diagnose the local toolchain |
+| `caffeine_config_list` / `caffeine_config_get` / `caffeine_config_set` | Manage CLI config |
+
+All tools return the same stable `{ ok, data }` / `{ ok, error }` envelope used by the CLI's `--json` mode.
+
+## Supported Platforms
+
+Native binaries ship for:
+
+- macOS arm64 and x64
+- Linux arm64 and x64, glibc and musl
+- Windows arm64 and x64
+
+## Troubleshooting
+
+- **Server shows as offline on first use.** Run `npx -y @caffeineai/mcp@dev --version` in a terminal, then restart your host.
+- **Not logged in errors.** Run `caffeine auth login` via the CLI. The MCP server does not have a separate login.
+- **Config changes not taking effect.** Most hosts do not hot-reload MCP configs. Restart the host after editing MCP config files.
+- **`command not found: npx`.** Install Node.js 20+ and ensure `npx` is on your `PATH`.
+
+## Quick Transport Check
+
+With no host running, you can pipe a JSON-RPC request directly:
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx -y @caffeineai/mcp@dev
+```
+
+## Links
+
+- Caffeine platform: https://caffeine.ai
+- Model Context Protocol: https://modelcontextprotocol.io
+
+This package installs the matching platform binary through npm optional dependencies. Install the main package rather than a platform package directly.

package/bin/caffeine-mcp.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn, spawnSync } = require("node:child_process");
+
+const packages = {
+  "darwin-arm64": {
+    "packageName": "@caffeineai/mcp-darwin-arm64",
+    "binary": "caffeine-mcp"
+  },
+  "darwin-x64": {
+    "packageName": "@caffeineai/mcp-darwin-x64",
+    "binary": "caffeine-mcp"
+  },
+  "linux-arm64-glibc": {
+    "packageName": "@caffeineai/mcp-linux-arm64-glibc",
+    "binary": "caffeine-mcp"
+  },
+  "linux-x64-glibc": {
+    "packageName": "@caffeineai/mcp-linux-x64-glibc",
+    "binary": "caffeine-mcp"
+  },
+  "linux-arm64-musl": {
+    "packageName": "@caffeineai/mcp-linux-arm64-musl",
+    "binary": "caffeine-mcp"
+  },
+  "linux-x64-musl": {
+    "packageName": "@caffeineai/mcp-linux-x64-musl",
+    "binary": "caffeine-mcp"
+  },
+  "win32-arm64": {
+    "packageName": "@caffeineai/mcp-win32-arm64",
+    "binary": "caffeine-mcp.exe"
+  },
+  "win32-x64": {
+    "packageName": "@caffeineai/mcp-win32-x64",
+    "binary": "caffeine-mcp.exe"
+  }
+};
+
+function linuxLibc() {
+  if (process.platform !== "linux") return "";
+
+  try {
+    const report = process.report && process.report.getReport && process.report.getReport();
+    if (report && report.header && report.header.glibcVersionRuntime) return "glibc";
+  } catch {}
+
+  try {
+    const result = spawnSync("ldd", ["--version"], { encoding: "utf8" });
+    const text = String(result.stdout || "") + String(result.stderr || "");
+    if (text.toLowerCase().includes("musl")) return "musl";
+  } catch {}
+
+  return "glibc";
+}
+
+function platformKey() {
+  switch (process.platform) {
+    case "darwin":
+      return `darwin-${process.arch}`;
+    case "linux":
+      return `linux-${process.arch}-${linuxLibc()}`;
+    case "win32":
+      return `win32-${process.arch}`;
+    default:
+      return "";
+  }
+}
+
+const key = platformKey();
+const selected = packages[key];
+
+if (!selected) {
+  console.error("caffeine-mcp: unsupported platform " + process.platform + "/" + process.arch);
+  process.exit(1);
+}
+
+let bin;
+try {
+  bin = require.resolve(selected.packageName + "/bin/" + selected.binary);
+} catch {
+  console.error("caffeine-mcp: missing platform package " + selected.packageName);
+  console.error("Reinstall without --omit=optional.");
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    console.error("caffeine-mcp: terminated by " + signal);
+    process.exit(1);
+  }
+
+  process.exit(code ?? 0);
+});
+
+child.on("error", (err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@caffeineai/mcp",
+  "version": "0.1.0-dev.0",
+  "description": "Caffeine MCP server",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caffeinelabs/caffeine-cli.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "caffeine-mcp": "bin/caffeine-mcp.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@caffeineai/mcp-darwin-arm64": "0.1.0-dev.0",
+    "@caffeineai/mcp-darwin-x64": "0.1.0-dev.0",
+    "@caffeineai/mcp-linux-arm64-glibc": "0.1.0-dev.0",
+    "@caffeineai/mcp-linux-x64-glibc": "0.1.0-dev.0",
+    "@caffeineai/mcp-linux-arm64-musl": "0.1.0-dev.0",
+    "@caffeineai/mcp-linux-x64-musl": "0.1.0-dev.0",
+    "@caffeineai/mcp-win32-arm64": "0.1.0-dev.0",
+    "@caffeineai/mcp-win32-x64": "0.1.0-dev.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}