@ign8t/mcp 0.0.1 → 0.1.1

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,21 +41,25 @@ 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):
 
@@ -63,10 +67,8 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 {
   "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"]
     }
   }
 }
@@ -78,6 +80,47 @@ 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 using command line arguments (recommended) or environment variables:
+
+**Using arguments (recommended):**
+
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "ign8t-mcp",
+      "args": ["--api-key", "your-api-key-here"]
+    }
+  }
+}
+```
+
+**Using environment variables (legacy):**
+
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "ign8t-mcp",
+      "env": {
+        "IGN8T_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+</details>
+
 ### 4. Verify Installation
 
 Ask your AI assistant:
@@ -177,21 +220,22 @@ 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": "ign8t-mcp",
-      "env": {
-        "IGN8T_API_KEY": "your-api-key",
-        "IGN8T_API_URL": "https://your-domain.com" // Optional - only for custom deployments
-      }
+      "command": "npx",
+      "args": ["-y", "@ign8t/mcp@latest", "--api-key", "your-api-key"]
     }
   }
 }
 ```
 
-**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`)
@@ -199,19 +243,16 @@ The MCP server connects to `https://ign8t.com` by default. For enterprise deploy
 
 ### Development Mode
 
-For local development and testing:
+For contributors working on the MCP server itself:
 
 1. Clone this repository
 2. Install dependencies: `pnpm install`
-3. Copy `.env.example` to `.env` and add your API key (for development only!)
-4. Run in dev mode: `pnpm dev`
-5. Configure your AI tool to use the local path
-
-**Note**: The `.env` file is ONLY for developers working on the MCP server itself. End users should configure their API key in their IDE's MCP settings, not in `.env` files.
+3. Build the project: `pnpm build`
+4. Test locally: `pnpm dev --api-key your-key`
 
 ## Contributing
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+We welcome contributions! If you'd like to contribute to the ign8t MCP server:
 
 ### Development Setup
 
@@ -228,7 +269,7 @@ pnpm test
 
 # Build
 pnpm build
-```
+````
 
 ## Support
 

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 = config.apiUrl || "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.1",
   "description": "MCP server for ign8t project management - AI IDE integration",
   "type": "module",
   "main": "dist/index.js",
@@ -13,10 +13,15 @@
   ],
   "scripts": {
     "build": "tsc",
+    "build:watch": "tsc --watch",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
+    "dev:help": "tsx src/index.ts --help",
     "clean": "rm -rf dist",
     "test": "node debug-mcp.js",
+    "test:local": "node dist/index.js --help",
+    "link:local": "npm link",
+    "unlink:local": "npm unlink -g @ign8t/mcp",
     "prepublishOnly": "pnpm clean && pnpm build"
   },
   "keywords": [