@ign8t/mcp 0.0.1 → 0.1.0

package/README.md

@@ -33,7 +33,7 @@ pnpm install -g @ign8t/mcp
 ### 3. Configure Your AI Tool
 
 <details>
-<summary><strong>Cursor IDE</strong></summary>
+<summary><strong>Cursor IDE (Recommended - using npx)</strong></summary>
 
 Add to `~/.cursor/mcp/settings.json`:
 
@@ -41,40 +41,85 @@ Add to `~/.cursor/mcp/settings.json`:
 {
   "mcpServers": {
     "ign8t": {
-      "command": "ign8t-mcp",
-      "env": {
-        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
-      }
+      "command": "npx",
+      "args": ["-y", "@ign8t/mcp@latest", "--api-key", "your-api-key-here"]
     }
   }
 }
 ```
 
+**Benefits of npx approach:**
+
+- Always uses the latest version
+- No global installation needed
+- Cleaner configuration
+
 Restart Cursor to activate the integration.
 
 </details>
 
 <details>
-<summary><strong>Claude Desktop</strong></summary>
+<summary><strong>Claude Desktop (Recommended - using npx)</strong></summary>
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
 
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "npx",
+      "args": ["-y", "@ign8t/mcp@latest", "--api-key", "your-api-key-here"]
+    }
+  }
+}
+```
+
+For Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Restart Claude Desktop to activate.
+
+</details>
+
+<details>
+<summary><strong>Alternative: Global Installation Method</strong></summary>
+
+If you prefer to install globally first:
+
+```bash
+pnpm install -g @ign8t/mcp
+```
+
+Then configure with environment variables:
+
+**Cursor IDE:**
+
 ```json
 {
   "mcpServers": {
     "ign8t": {
       "command": "ign8t-mcp",
       "env": {
-        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
+        "IGN8T_API_KEY": "your-api-key-here"
       }
     }
   }
 }
 ```
 
-For Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+**Claude Desktop:**
 
-Restart Claude Desktop to activate.
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "ign8t-mcp",
+      "env": {
+        "IGN8T_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
 
 </details>
 
@@ -177,6 +222,21 @@ The ign8t MCP server is designed to fit seamlessly into your development workflo
 
 The MCP server connects to `https://ign8t.com` by default. For enterprise deployments, self-hosted instances, or local development, you can override the API endpoint:
 
+**Using npx (Recommended):**
+
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "npx",
+      "args": ["-y", "@ign8t/mcp@latest", "--api-key", "your-api-key", "--api-url", "https://your-domain.com"]
+    }
+  }
+}
+```
+
+**Using global installation:**
+
 ```json
 {
   "mcpServers": {
@@ -184,14 +244,14 @@ The MCP server connects to `https://ign8t.com` by default. For enterprise deploy
       "command": "ign8t-mcp",
       "env": {
         "IGN8T_API_KEY": "your-api-key",
-        "IGN8T_API_URL": "https://your-domain.com" // Optional - only for custom deployments
+        "IGN8T_API_URL": "https://your-domain.com"
       }
     }
   }
 }
 ```
 
-**Note**: Most users don't need to set `IGN8T_API_URL`. It's only required if you're:
+**Note**: Most users don't need to set a custom API URL. It's only required if you're:
 
 - Using an enterprise or self-hosted ign8t instance
 - Developing locally (e.g., `http://localhost:3000`)

package/dist/index.js

@@ -5,11 +5,48 @@ import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSche
 import * as dotenv from "dotenv";
 // Load environment variables
 dotenv.config();
+// Parse command line arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {};
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case "--api-key":
+                config.apiKey = args[i + 1];
+                i++; // Skip next argument as it's the value
+                break;
+            case "--api-url":
+                config.apiUrl = args[i + 1];
+                i++; // Skip next argument as it's the value
+                break;
+            case "--help":
+            case "-h":
+                console.log(`
+ign8t MCP Server
+
+Usage: ign8t-mcp --api-key <key> [--api-url <url>]
+
+Options:
+  --api-key <key>    Your ign8t API key (required)
+  --api-url <url>    Custom API URL (optional, defaults to https://ign8t.com)
+  --help, -h         Show this help message
+
+Get your API key from: https://ign8t.com/settings/api-keys
+        `);
+                process.exit(0);
+                break;
+        }
+    }
+    return config;
+}
 // Configuration
-const API_KEY = process.env.IGN8T_API_KEY;
-const API_URL = process.env.IGN8T_API_URL || "https://ign8t.com";
+const config = parseArgs();
+const API_KEY = config.apiKey;
+const API_URL = "https://ign8t.com";
 if (!API_KEY) {
-    console.error("Error: IGN8T_API_KEY environment variable is required");
+    console.error("Error: API key is required");
+    console.error("Usage: ign8t-mcp --api-key <your-api-key>");
+    console.error("Or set IGN8T_API_KEY environment variable");
     console.error("Get your API key from https://ign8t.com/settings/api-keys");
     process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ign8t/mcp",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "MCP server for ign8t project management - AI IDE integration",
   "type": "module",
   "main": "dist/index.js",