thetoolforthat 1.0.0 → 1.1.0

package/README.md

@@ -6,25 +6,91 @@ Tools, resources, and people worth knowing. A curated collection for builders an
 
 ## MCP Server
 
-This repo includes an MCP server so AI coding agents can search and recommend tools. No cloning required - install via npm and updates sync automatically from this repo.
+This repo includes an MCP server so AI coding agents can search and recommend tools. Updates sync automatically from this repo.
 
-### Add to Claude Code
+### Quick Start
 
-Add to your `~/.claude/settings.json`:
+Select your client and run the command:
+
+<details open>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+npx thetoolforthat init --client claude
+```
+
+Restart Claude Code and try:
+- Search for animation libraries
+- Recommend tools for building a SaaS dashboard
+- List all design agencies
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+```bash
+npx thetoolforthat init --client cursor
+```
+
+Open Cursor Settings and enable the MCP server for thetoolforthat.
+
+</details>
+
+<details>
+<summary><strong>VS Code</strong></summary>
+
+```bash
+npx thetoolforthat init --client vscode
+```
+
+Open `.vscode/mcp.json` and click Start next to thetoolforthat.
+
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+```bash
+npx thetoolforthat init --client codex
+```
+
+Then add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.thetoolforthat]
+command = "npx"
+args = ["thetoolforthat", "mcp"]
+```
+
+</details>
+
+<details>
+<summary><strong>OpenCode</strong></summary>
+
+```bash
+npx thetoolforthat init --client opencode
+```
+
+Restart OpenCode and you're ready.
+
+</details>
+
+### Manual Configuration
+
+Add to your MCP config:
 
 ```json
 {
   "mcpServers": {
     "thetoolforthat": {
       "command": "npx",
-      "args": ["thetoolforthat"]
+      "args": ["thetoolforthat", "mcp"]
     }
   }
 }
 ```
 
-That's it. The server fetches the latest tools from this repo (cached 5 minutes).
-
 ### Available Tools
 
 | Tool | Description |

package/cli.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+import { program } from "commander";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const CONFIG_PATHS = {
+  claude: join(homedir(), ".claude", "settings.json"),
+  cursor: join(process.cwd(), ".cursor", "mcp.json"),
+  vscode: join(process.cwd(), ".vscode", "mcp.json"),
+  codex: join(homedir(), ".codex", "config.toml"),
+  opencode: join(homedir(), ".opencode", "mcp.json"),
+};
+
+const MCP_CONFIG = {
+  command: "npx",
+  args: ["thetoolforthat", "mcp"],
+};
+
+function ensureDir(filePath) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+function readJsonConfig(path) {
+  if (!existsSync(path)) {
+    return {};
+  }
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function writeJsonConfig(path, config) {
+  ensureDir(path);
+  writeFileSync(path, JSON.stringify(config, null, 2) + "\n");
+}
+
+function initClaude() {
+  const configPath = CONFIG_PATHS.claude;
+  const config = readJsonConfig(configPath);
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  config.mcpServers.thetoolforthat = MCP_CONFIG;
+
+  writeJsonConfig(configPath, config);
+  console.log(`✓ Added thetoolforthat to ${configPath}`);
+  console.log("\nRestart Claude Code and try:");
+  console.log("  - Search for animation libraries");
+  console.log("  - Recommend tools for building a SaaS dashboard");
+  console.log("  - List all design agencies");
+}
+
+function initCursor() {
+  const configPath = CONFIG_PATHS.cursor;
+  const config = readJsonConfig(configPath);
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  config.mcpServers.thetoolforthat = MCP_CONFIG;
+
+  writeJsonConfig(configPath, config);
+  console.log(`✓ Added thetoolforthat to ${configPath}`);
+  console.log("\nOpen Cursor Settings and enable the MCP server for thetoolforthat.");
+  console.log("\nThen try:");
+  console.log("  - Search for animation libraries");
+  console.log("  - Recommend tools for building a SaaS dashboard");
+}
+
+function initVscode() {
+  const configPath = CONFIG_PATHS.vscode;
+  const config = readJsonConfig(configPath);
+
+  if (!config.servers) {
+    config.servers = {};
+  }
+
+  config.servers.thetoolforthat = MCP_CONFIG;
+
+  writeJsonConfig(configPath, config);
+  console.log(`✓ Added thetoolforthat to ${configPath}`);
+  console.log("\nOpen .vscode/mcp.json and click Start next to thetoolforthat.");
+  console.log("\nThen try with GitHub Copilot:");
+  console.log("  - Search for animation libraries");
+  console.log("  - Recommend tools for building a SaaS dashboard");
+}
+
+function initCodex() {
+  console.log(`To configure Codex, add this to ~/.codex/config.toml:\n`);
+  console.log(`[mcp_servers.thetoolforthat]`);
+  console.log(`command = "npx"`);
+  console.log(`args = ["thetoolforthat", "mcp"]`);
+  console.log("\nThen restart Codex and try:");
+  console.log("  - Search for animation libraries");
+  console.log("  - Recommend tools for building a SaaS dashboard");
+}
+
+function initOpencode() {
+  const configPath = CONFIG_PATHS.opencode;
+  const config = readJsonConfig(configPath);
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  config.mcpServers.thetoolforthat = MCP_CONFIG;
+
+  writeJsonConfig(configPath, config);
+  console.log(`✓ Added thetoolforthat to ${configPath}`);
+  console.log("\nRestart OpenCode and try:");
+  console.log("  - Search for animation libraries");
+  console.log("  - Recommend tools for building a SaaS dashboard");
+}
+
+program
+  .name("thetoolforthat")
+  .description("Curated tools, resources, and agencies for builders")
+  .version("1.0.0");
+
+program
+  .command("init")
+  .description("Configure the MCP server for your AI coding client")
+  .option("-c, --client <client>", "Client to configure (claude, cursor, vscode, codex, opencode)")
+  .action((options) => {
+    const client = options.client?.toLowerCase();
+
+    if (!client) {
+      console.log("Available clients: claude, cursor, vscode, codex, opencode");
+      console.log("\nUsage: npx thetoolforthat init --client <client>");
+      console.log("Example: npx thetoolforthat init --client claude");
+      return;
+    }
+
+    switch (client) {
+      case "claude":
+        initClaude();
+        break;
+      case "cursor":
+        initCursor();
+        break;
+      case "vscode":
+        initVscode();
+        break;
+      case "codex":
+        initCodex();
+        break;
+      case "opencode":
+        initOpencode();
+        break;
+      default:
+        console.error(`Unknown client: ${client}`);
+        console.log("Available clients: claude, cursor, vscode, codex, opencode");
+        process.exit(1);
+    }
+  });
+
+program
+  .command("mcp")
+  .description("Start the MCP server")
+  .action(async () => {
+    // Import and run the server
+    await import("./server.js");
+  });
+
+// Default command (no args) - show help
+program.action(() => {
+  program.help();
+});
+
+program.parse();

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "thetoolforthat",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for searching curated developer tools, design resources, and agencies",
   "type": "module",
-  "main": "server.js",
+  "main": "cli.js",
   "bin": {
-    "thetoolforthat": "./server.js"
+    "thetoolforthat": "./cli.js"
   },
   "files": [
+    "cli.js",
     "server.js"
   ],
   "scripts": {
-    "start": "node server.js"
+    "start": "node cli.js mcp"
   },
   "keywords": [
     "mcp",
@@ -32,6 +33,7 @@
   "homepage": "https://github.com/pipeabellos/thetoolforthat#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
+    "commander": "^14.0.2",
     "zod": "^4.3.5"
   }
 }