thetoolforthat 1.0.0 → 1.2.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,153 @@
+#!/usr/bin/env node
+
+import { program } from "commander";
+import { execSync } from "child_process";
+
+const MCP_CONFIG = JSON.stringify({
+  command: "npx",
+  args: ["thetoolforthat", "mcp"],
+});
+
+function runCommand(cmd) {
+  try {
+    execSync(cmd, { stdio: "inherit" });
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+function initClaude() {
+  console.log("Adding thetoolforthat to Claude Code...\n");
+
+  // Use claude mcp add-json with user scope
+  const success = runCommand(
+    `claude mcp add-json --scope user thetoolforthat '${MCP_CONFIG}'`
+  );
+
+  if (success) {
+    console.log("\n✓ Added thetoolforthat MCP server");
+    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");
+  } else {
+    console.error("\nFailed to add MCP server. Try manually:");
+    console.log(`\nclaude mcp add-json --scope user thetoolforthat '${MCP_CONFIG}'`);
+  }
+}
+
+function initCursor() {
+  console.log("Adding thetoolforthat to Cursor...\n");
+
+  const config = {
+    mcpServers: {
+      thetoolforthat: {
+        command: "npx",
+        args: ["thetoolforthat", "mcp"],
+      },
+    },
+  };
+
+  console.log("Add this to .cursor/mcp.json in your project:\n");
+  console.log(JSON.stringify(config, null, 2));
+  console.log("\nThen open Cursor Settings and enable the MCP server.");
+}
+
+function initVscode() {
+  console.log("Adding thetoolforthat to VS Code...\n");
+
+  const config = {
+    servers: {
+      thetoolforthat: {
+        command: "npx",
+        args: ["thetoolforthat", "mcp"],
+      },
+    },
+  };
+
+  console.log("Add this to .vscode/mcp.json in your project:\n");
+  console.log(JSON.stringify(config, null, 2));
+  console.log("\nThen click Start next to thetoolforthat in the MCP panel.");
+}
+
+function initCodex() {
+  console.log("Adding thetoolforthat to Codex...\n");
+  console.log("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.");
+}
+
+function initOpencode() {
+  console.log("Adding thetoolforthat to OpenCode...\n");
+
+  const config = {
+    mcpServers: {
+      thetoolforthat: {
+        command: "npx",
+        args: ["thetoolforthat", "mcp"],
+      },
+    },
+  };
+
+  console.log("Add this to ~/.opencode/mcp.json:\n");
+  console.log(JSON.stringify(config, null, 2));
+  console.log("\nThen restart OpenCode.");
+}
+
+program
+  .name("thetoolforthat")
+  .description("Curated tools, resources, and agencies for builders")
+  .version("1.2.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\n");
+      console.log("Usage: 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 () => {
+    await import("./server.js");
+  });
+
+program.action(() => {
+  program.help();
+});
+
+program.parse();

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "thetoolforthat",
-  "version": "1.0.0",
+  "version": "1.2.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"
   }
 }