@ign8t/mcp 0.0.1

package/README.md

@@ -0,0 +1,246 @@
+# ign8t MCP Server
+
+Seamlessly integrate ign8t project management into your AI-powered development workflow. Access your projects, documents, and tasks directly from Cursor, Claude Desktop, and other MCP-compatible AI tools.
+
+## What is MCP?
+
+Model Context Protocol (MCP) is an open standard that enables AI assistants to securely access external tools and data sources. With the ign8t MCP server, your AI assistant can:
+
+- 📋 Access all your ign8t projects without switching contexts
+- 📄 Read BRD, PRD, and TRD documents to understand requirements
+- 📊 View and manage your backlog in real-time
+- ✅ Update task statuses as you complete work
+- 🔍 Search across all tasks and projects
+- 🎯 Get AI-powered task recommendations
+- 🧠 Access full context including related requirements and documentation
+
+## Quick Start
+
+### 1. Install the MCP Server
+
+```bash
+pnpm install -g @ign8t/mcp
+```
+
+### 2. Get Your API Key
+
+1. Log in to [ign8t.com](https://ign8t.com)
+2. Navigate to **Settings → API Keys**
+3. Click **"Create New API Key"**
+4. Give it a descriptive name (e.g., "Cursor Integration")
+5. Copy the generated key (you won't see it again!)
+
+### 3. Configure Your AI Tool
+
+<details>
+<summary><strong>Cursor IDE</strong></summary>
+
+Add to `~/.cursor/mcp/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "ign8t-mcp",
+      "env": {
+        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
+      }
+    }
+  }
+}
+```
+
+Restart Cursor to activate the integration.
+
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "ign8t": {
+      "command": "ign8t-mcp",
+      "env": {
+        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
+      }
+    }
+  }
+}
+```
+
+For Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Restart Claude Desktop to activate.
+
+</details>
+
+### 4. Verify Installation
+
+Ask your AI assistant:
+
+```
+"Can you list my ign8t projects?"
+```
+
+If configured correctly, it will show your active projects!
+
+## Usage Examples
+
+Once configured, you can interact with ign8t naturally through your AI assistant:
+
+### Project Management
+
+```
+"Show me all my active projects"
+"Get details about the [project name] project"
+"Show me the BRD for [project name]"
+"Display all documents for my current project"
+```
+
+### Task Workflow
+
+```
+"What should I work on next?"
+"Show me the backlog for [project name]"
+"Search for tasks related to authentication"
+"Update task [id] to in_progress"
+"Mark task [id] as done with note: 'Implemented OAuth2'"
+"Get full context for task [id]"
+```
+
+### Resources
+
+The MCP server also provides quick access to resources:
+
+- `ign8t://projects` - List of all your projects
+- `ign8t://current-tasks` - Your active tasks across all projects
+
+## Available Tools Reference
+
+| Tool                 | Description                                   | Example Use                                 |
+| -------------------- | --------------------------------------------- | ------------------------------------------- |
+| `list_projects`      | List all projects with optional status filter | "Show my archived projects"                 |
+| `get_project`        | Get detailed project information              | "Get details for project abc123"            |
+| `get_documents`      | Retrieve BRD, PRD, TRD documents              | "Show me the PRD for project xyz"           |
+| `get_backlog`        | View epics, stories, and tasks                | "Display backlog including completed items" |
+| `get_next_task`      | AI-recommended next task                      | "What should I work on next?"               |
+| `update_task_status` | Change task status with notes                 | "Set task 123 to blocked: waiting on API"   |
+| `search_tasks`       | Search across tasks                           | "Find all tasks mentioning 'payment'"       |
+| `get_task_context`   | Full task context with requirements           | "Show context for task 456"                 |
+
+## Workflow Integration
+
+The ign8t MCP server is designed to fit seamlessly into your development workflow:
+
+1. **Start your day**: "What are my current tasks?"
+2. **Get context**: "Show me the requirements for this task"
+3. **Update progress**: "Mark this task as in progress"
+4. **Search when stuck**: "Find similar tasks I've completed"
+5. **Complete work**: "Mark task as done and get my next task"
+
+## Troubleshooting
+
+<details>
+<summary><strong>AI assistant can't find ign8t commands</strong></summary>
+
+1. Verify the MCP server is installed: `which ign8t-mcp`
+2. Check your AI tool's configuration file has the correct path
+3. Restart your AI tool after configuration changes
+4. Ensure your API key is valid and active
+</details>
+
+<details>
+<summary><strong>Getting "Invalid API key" errors</strong></summary>
+
+1. Verify your API key in the ign8t dashboard
+2. Check that the key is correctly set in your configuration
+3. Ensure there are no extra spaces or quotes around the key
+4. Generate a new key if the current one isn't working
+</details>
+
+<details>
+<summary><strong>Can't see my projects</strong></summary>
+
+1. Ensure you're logged into the correct ign8t account
+2. Verify the API key belongs to your account
+3. Check that you have active projects in ign8t
+4. Try the command "list all my projects including archived"
+</details>
+
+## Advanced Configuration
+
+### Custom API Endpoint (Optional)
+
+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:
+
+```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
+      }
+    }
+  }
+}
+```
+
+**Note**: Most users don't need to set `IGN8T_API_URL`. It's only required if you're:
+
+- Using an enterprise or self-hosted ign8t instance
+- Developing locally (e.g., `http://localhost:3000`)
+- Using a custom domain
+
+### Development Mode
+
+For local development and testing:
+
+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.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/ign8t/mcp-server.git
+cd mcp-server
+
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Build
+pnpm build
+```
+
+## Support
+
+- 📚 **Documentation**: [docs.ign8t.com/mcp](https://docs.ign8t.com/mcp)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/ign8t/mcp-server/issues)
+- 💬 **Community**: [Discord](https://discord.gg/ign8t)
+- 📧 **Email**: support@ign8t.com
+
+## License
+
+MIT © ign8t team
+
+---
+
+Built with ❤️ by the ign8t team to enhance your AI-powered development workflow.

package/dist/index.js

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as dotenv from "dotenv";
+// Load environment variables
+dotenv.config();
+// Configuration
+const API_KEY = process.env.IGN8T_API_KEY;
+const API_URL = process.env.IGN8T_API_URL || "https://ign8t.com";
+if (!API_KEY) {
+    console.error("Error: IGN8T_API_KEY environment variable is required");
+    console.error("Get your API key from https://ign8t.com/settings/api-keys");
+    process.exit(1);
+}
+// Create MCP server instance
+const server = new Server({
+    name: "ign8t-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+// Helper function to call ign8t API
+async function callIgn8tAPI(endpoint, data = {}) {
+    try {
+        const response = await fetch(`${API_URL}/api/mcp${endpoint}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(error || `API error: ${response.status}`);
+        }
+        return response.json();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error("Failed to connect to ign8t API");
+    }
+}
+// Define available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "list_projects",
+                description: "List all your ign8t projects",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        status: {
+                            type: "string",
+                            enum: ["active", "archived", "all"],
+                            description: "Filter by project status",
+                            default: "active",
+                        },
+                    },
+                },
+            },
+            {
+                name: "get_project",
+                description: "Get detailed information about a specific project",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+            {
+                name: "get_documents",
+                description: "Get BRD, PRD, and TRD documents for a project",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                        document_type: {
+                            type: "string",
+                            enum: ["brd", "prd", "trd", "all"],
+                            description: "Type of document to retrieve",
+                            default: "all",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+            {
+                name: "get_backlog",
+                description: "Get the backlog (epics, stories, tasks) for a project",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                        include_completed: {
+                            type: "boolean",
+                            description: "Include completed tasks",
+                            default: false,
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+            {
+                name: "get_next_task",
+                description: "Get the next recommended task to work on",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The project ID",
+                        },
+                        context: {
+                            type: "string",
+                            description: "Optional context about what you want to work on",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
+            {
+                name: "update_task_status",
+                description: "Update the status of a task",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        task_id: {
+                            type: "string",
+                            description: "The task ID",
+                        },
+                        status: {
+                            type: "string",
+                            enum: ["todo", "in_progress", "review", "done", "blocked"],
+                            description: "New status for the task",
+                        },
+                        notes: {
+                            type: "string",
+                            description: "Optional notes about the status change",
+                        },
+                    },
+                    required: ["task_id", "status"],
+                },
+            },
+            {
+                name: "search_tasks",
+                description: "Search for tasks across all your projects or within a specific project",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search query",
+                        },
+                        project_id: {
+                            type: "string",
+                            description: "Optional: limit search to specific project",
+                        },
+                        status: {
+                            type: "string",
+                            enum: ["todo", "in_progress", "review", "done", "blocked", "all"],
+                            description: "Filter by status",
+                            default: "all",
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "get_task_context",
+                description: "Get full context for a task including related BRD/PRD/TRD sections",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        task_id: {
+                            type: "string",
+                            description: "The task ID",
+                        },
+                    },
+                    required: ["task_id"],
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case "list_projects":
+                result = await callIgn8tAPI("/projects/list", args);
+                break;
+            case "get_project":
+                result = await callIgn8tAPI("/projects/get", args);
+                break;
+            case "get_documents":
+                result = await callIgn8tAPI("/documents/get", args);
+                break;
+            case "get_backlog":
+                result = await callIgn8tAPI("/backlog/get", args);
+                break;
+            case "get_next_task":
+                result = await callIgn8tAPI("/tasks/next", args);
+                break;
+            case "update_task_status":
+                result = await callIgn8tAPI("/tasks/update-status", args);
+                break;
+            case "search_tasks":
+                result = await callIgn8tAPI("/tasks/search", args);
+                break;
+            case "get_task_context":
+                result = await callIgn8tAPI("/tasks/context", args);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Define available resources
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: "ign8t://projects",
+                name: "Your Projects",
+                description: "List of all your ign8t projects",
+                mimeType: "application/json",
+            },
+            {
+                uri: "ign8t://current-tasks",
+                name: "Current Tasks",
+                description: "Your current in-progress tasks across all projects",
+                mimeType: "application/json",
+            },
+        ],
+    };
+});
+// Handle resource reads
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    try {
+        if (uri === "ign8t://projects") {
+            const projects = await callIgn8tAPI("/projects/list", { status: "active" });
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "application/json",
+                        text: JSON.stringify(projects, null, 2),
+                    },
+                ],
+            };
+        }
+        if (uri === "ign8t://current-tasks") {
+            const tasks = await callIgn8tAPI("/tasks/current", {});
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "application/json",
+                        text: JSON.stringify(tasks, null, 2),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    }
+    catch (error) {
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : "Unknown error",
+                    }),
+                },
+            ],
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("ign8t MCP server v1.0.0");
+    console.error(`Connected to: ${API_URL}`);
+    console.error("Ready to serve requests...");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ign8t/mcp",
+  "version": "0.0.1",
+  "description": "MCP server for ign8t project management - AI IDE integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ign8t-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "clean": "rm -rf dist",
+    "test": "node debug-mcp.js",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  },
+  "keywords": [
+    "mcp",
+    "ign8t",
+    "ai",
+    "ai-ide",
+    "cursor",
+    "claude"
+  ],
+  "author": "nocodecat",
+  "license": "MIT",
+  "homepage": "https://github.com/nocodecat/mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nocodecat/mcp-server.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}