feat: add CraftTable MCP OAuth CLI

2026-08-15 20:38:50 +08:00
commit 7c033b6118
19 changed files with 4053 additions and 0 deletions
@@ -0,0 +1,37 @@
+# CraftTable MCP CLI
+
+`@game-crafttable/mcp-client` provides the `crafttable-mcp` command and the compatibility alias `crafttable-mcp-client`.
+
+## Quick install and configure
+
+The repository is private, so first make sure Git Credential Manager can access `git.crash.work`, then run this in PowerShell:
+
+```powershell
+npm install --global git+https://git.crash.work/cneicy/crafttable-mcp-client.git; crafttable-mcp login; crafttable-mcp configure all
+```
+
+This installs the CLI, opens the browser for OAuth login, and configures the same local stdio bridge for Codex, Claude Code, and OpenCode at user scope.
+
+## Commands
+
+```powershell
+crafttable-mcp login
+crafttable-mcp status
+crafttable-mcp tools
+crafttable-mcp call list_spaces '{}'
+crafttable-mcp configure all
+```
+
+`login` uses Authorization Code with PKCE and saves OAuth tokens in the operating-system credential store. Tokens are isolated by MCP server URL and OAuth client ID. The CLI never falls back to a plaintext token file.
+
+`serve` is a stdio MCP bridge for Codex, Claude Code, and OpenCode. It writes MCP JSON-RPC only to stdout. If no OAuth credential exists, it can use the legacy `CRAFTTABLE_MCP_TOKEN` environment variable and reports that path only on stderr.
+
+Connection defaults:
+
+- URL: `https://crafttable.crash.work/mcp`
+- OAuth client ID: `crafttable-mcp-cli`
+- callback: `http://127.0.0.1:48321/oauth/callback`
+
+Override them with `--url`, `--client-id`, and `--callback-port`, or with `CRAFTTABLE_MCP_URL`, `CRAFTTABLE_MCP_OAUTH_CLIENT_ID`, and `CRAFTTABLE_MCP_OAUTH_CALLBACK_PORT`.
+
+Only HTTPS remote URLs are accepted. Plain HTTP is limited to `localhost`, `127.0.0.1`, and `::1` development servers.