@projora/mcp-server 1.2.0 → 1.3.0

package/README.md

@@ -4,27 +4,18 @@ A Model Context Protocol (MCP) server for [Projora](https://projora.app) task ma
 
 ## Features
 
-### Task Management
-- **create_task** - Create a new task in a project (specify project key, title, and optional details)
 - **start_task** - Start working on a task (sets status to "In Progress", adds comment, returns full context)
 - **complete_task** - Mark a task as done with an optional summary
 - **get_task** - Get a specific task by its key (e.g., "PRJ-123")
-- **update_task** - Update task fields (title, description, priority, assignee, due date)
-- **update_task_status** - Update task status
-
-### Task Lists
+- **list_projects** - List all projects
 - **list_tasks** - List tasks with optional filters (project, status, priority, assignee)
 - **my_tasks** - Get tasks assigned to you
 - **overdue_tasks** - Get all overdue tasks
 - **search_tasks** - Search for tasks and projects by keyword
-
-### Collaboration
+- **update_task** - Update task fields (title, description, priority, assignee, due date)
+- **update_task_status** - Update task status
 - **add_comment** - Add a comment to a task
 - **log_time** - Log time worked on a task
-- **link_branch** - Link a git branch or pull request to a task
-
-### Projects & Config
-- **list_projects** - List all projects
 - **get_project** - Get project details including linked GitHub repository
 - **get_config** - Get available statuses, priorities, and task types
 - **dashboard_stats** - Get dashboard statistics
@@ -41,18 +32,27 @@ Or install globally:
 npm install -g @projora/mcp-server
 ```
 
-## Configuration
+## Quick Setup
+
+Run this single command to automatically configure Claude Code or OpenCode:
 
-The server requires two environment variables:
+```bash
+npx @projora/mcp-server setup
+```
 
-- `PROJORA_GRAPHQL_URL` - Your Projora GraphQL endpoint (defaults to `https://api.projora.app/graphql`)
-- `PROJORA_AUTH_TOKEN` - Your API token from Projora
+The setup wizard will:
+1. Prompt for your API token (get it from [Projora Settings](https://projora.app/settings/integrations))
+2. Automatically configure your AI coding assistant
+3. No manual editing of config files required!
 
-Get your API token from **Settings > Integrations** in the Projora web app.
+### Manual Configuration
 
-## Usage with Claude Code
+If you prefer to manually configure, see below:
 
-Add to your Claude Code configuration (`~/.claude.json`):
+<details>
+<summary>Claude Code Manual Setup</summary>
+
+Add to your `~/.claude.json`:
 
 ```json
 {
@@ -65,10 +65,12 @@ Add to your Claude Code configuration (`~/.claude.json`):
   }
 }
 ```
+</details>
 
-## Usage with OpenCode
+<details>
+<summary>OpenCode Manual Setup</summary>
 
-Add to your OpenCode configuration (`opencode.json`):
+Add to your `opencode.json`:
 
 ```json
 {
@@ -84,15 +86,17 @@ Add to your OpenCode configuration (`opencode.json`):
   }
 }
 ```
+</details>
+
+### Environment Variables
 
-> Note: `PROJORA_GRAPHQL_URL` defaults to `https://api.projora.app/graphql`. Only set it if you're using a self-hosted instance.
+- `PROJORA_AUTH_TOKEN` - Your API token (required)
+- `PROJORA_GRAPHQL_URL` - GraphQL endpoint (defaults to `https://api.projora.app/graphql`, only set for self-hosted)
 
 ## Example Prompts
 
 Once configured, use prompts like:
 
-- "Create a task in project PRJ: Fix the login button"
-- "Create a task in PRJ with title 'Add unit tests' and assign it to me"
 - "Start working on task PRJ-123"
 - "Show me my tasks"
 - "What are the overdue tasks?"
@@ -103,18 +107,14 @@ Once configured, use prompts like:
 
 ## Workflow Example
 
-1. **Create a task**: "Use projora to create a task in project PRJ: Implement user authentication"
-   - Task is created in the specified project
-   - Returns the task key (e.g., PRJ-123) for reference
-
-2. **Start the task**: "Use projora to start working on task PRJ-123"
+1. **Start a task**: "Use projora to start working on task PRJ-123"
    - Status automatically changes to "In Progress"
    - A comment is added noting work has started
    - You get the full task context including description, GitHub repo, and suggested branch name
 
-3. **Work on the task**: Make your changes, commit code, etc.
+2. **Work on the task**: Make your changes, commit code, etc.
 
-4. **Complete the task**: "Use projora to complete task PRJ-123 with summary: Implemented the new feature with tests"
+3. **Complete the task**: "Use projora to complete task PRJ-123 with summary: Implemented the new feature with tests"
    - Status changes to "Done"
    - A completion comment is added with your summary
 

package/build/index.js

@@ -1066,167 +1066,7 @@ server.registerTool("update_task", {
         content: [{ type: "text", text: `Updated ${result.updateTask.taskKey}: ${updatedFields}` }],
     };
 });
-// 14. Create a new task
-server.registerTool("create_task", {
-    description: "Create a new task in a project. You can specify the project by key and optionally the task list name, or provide IDs directly. Returns the created task details.",
-    inputSchema: {
-        projectKey: z.string().optional().describe("The project key (e.g., 'PRJ'). Either projectKey or taskListId is required."),
-        taskListName: z.string().optional().describe("Name of the task list to add the task to (e.g., 'To Do', 'Backlog'). If not provided, uses the first task list."),
-        taskListId: z.string().optional().describe("The task list ID. If provided, projectKey and taskListName are ignored."),
-        title: z.string().describe("The task title (required)"),
-        description: z.string().optional().describe("Task description (supports markdown)"),
-        statusId: z.string().optional().describe("Status ID (use get_config to see available statuses)"),
-        priorityId: z.string().optional().describe("Priority ID (use get_config to see available priorities)"),
-        taskTypeId: z.string().optional().describe("Task type ID (use get_config to see available task types)"),
-        assigneeId: z.string().optional().describe("User ID to assign the task to"),
-        dueDate: z.string().optional().describe("Due date in YYYY-MM-DD format"),
-        startDate: z.string().optional().describe("Start date in YYYY-MM-DD format"),
-        estimatedHours: z.number().optional().describe("Estimated hours to complete the task"),
-    },
-}, async ({ projectKey, taskListName, taskListId, title, description, statusId, priorityId, taskTypeId, assigneeId, dueDate, startDate, estimatedHours }) => {
-    let resolvedTaskListId = taskListId;
-    let projectName = "";
-    // If taskListId is not provided, we need to look it up from projectKey
-    if (!resolvedTaskListId) {
-        if (!projectKey) {
-            return {
-                content: [{ type: "text", text: "Either projectKey or taskListId is required to create a task." }],
-            };
-        }
-        // Get project and its task lists
-        const projectQuery = `
-        query GetProjectWithTaskLists {
-          projects {
-            id
-            name
-            key
-            taskLists {
-              id
-              name
-              sortOrder
-            }
-          }
-        }
-      `;
-        const projectData = await graphqlQuery(projectQuery);
-        if (!projectData) {
-            return {
-                content: [{ type: "text", text: "Failed to fetch projects. Check your authentication token." }],
-            };
-        }
-        const project = projectData.projects.find(p => p.key.toLowerCase() === projectKey.toLowerCase());
-        if (!project) {
-            const availableProjects = projectData.projects.map(p => p.key).join(", ");
-            return {
-                content: [{ type: "text", text: `Project '${projectKey}' not found. Available projects: ${availableProjects}` }],
-            };
-        }
-        projectName = project.name;
-        if (project.taskLists.length === 0) {
-            return {
-                content: [{ type: "text", text: `Project '${projectKey}' has no task lists. Please create a task list first.` }],
-            };
-        }
-        // Find the task list by name or use the first one
-        if (taskListName) {
-            const taskList = project.taskLists.find(tl => tl.name.toLowerCase() === taskListName.toLowerCase());
-            if (!taskList) {
-                const availableLists = project.taskLists.map(tl => tl.name).join(", ");
-                return {
-                    content: [{ type: "text", text: `Task list '${taskListName}' not found in project '${projectKey}'. Available lists: ${availableLists}` }],
-                };
-            }
-            resolvedTaskListId = taskList.id;
-        }
-        else {
-            // Use the first task list (sorted by sortOrder)
-            const sortedLists = [...project.taskLists].sort((a, b) => a.sortOrder - b.sortOrder);
-            resolvedTaskListId = sortedLists[0].id;
-        }
-    }
-    // Build the input object
-    const input = {
-        taskListId: resolvedTaskListId,
-        title,
-    };
-    if (description !== undefined)
-        input.description = description;
-    if (statusId !== undefined)
-        input.statusId = statusId;
-    if (priorityId !== undefined)
-        input.priorityId = priorityId;
-    if (taskTypeId !== undefined)
-        input.taskTypeId = taskTypeId;
-    if (assigneeId !== undefined)
-        input.assigneeId = assigneeId;
-    if (dueDate !== undefined)
-        input.dueDate = dueDate;
-    if (startDate !== undefined)
-        input.startDate = startDate;
-    if (estimatedHours !== undefined)
-        input.estimatedHours = estimatedHours;
-    // Create the task
-    const mutation = `
-      mutation CreateTask($input: CreateTaskInput!) {
-        createTask(input: $input) {
-          id
-          taskKey
-          title
-          description
-          dueDate
-          startDate
-          estimatedHours
-          status { id name }
-          priority { id name }
-          taskType { id name }
-          assignee { id name }
-          project { id name key }
-          taskList { id name }
-          createdAt
-        }
-      }
-    `;
-    const result = await graphqlQuery(mutation, { input });
-    if (!result || !result.createTask) {
-        return {
-            content: [{ type: "text", text: "Failed to create task. Check your permissions and input values." }],
-        };
-    }
-    const task = result.createTask;
-    let output = `# Task Created: ${task.taskKey}\n\n`;
-    output += `**${task.title}**\n\n`;
-    output += `- **Project**: ${task.project.name} (${task.project.key})\n`;
-    output += `- **List**: ${task.taskList.name}\n`;
-    output += `- **Status**: ${task.status?.name || 'Default'}\n`;
-    if (task.priority) {
-        output += `- **Priority**: ${task.priority.name}\n`;
-    }
-    if (task.taskType) {
-        output += `- **Type**: ${task.taskType.name}\n`;
-    }
-    if (task.assignee) {
-        output += `- **Assignee**: ${task.assignee.name}\n`;
-    }
-    if (task.dueDate) {
-        output += `- **Due Date**: ${task.dueDate}\n`;
-    }
-    if (task.startDate) {
-        output += `- **Start Date**: ${task.startDate}\n`;
-    }
-    if (task.estimatedHours) {
-        output += `- **Estimate**: ${task.estimatedHours} hours\n`;
-    }
-    if (task.description) {
-        output += `\n## Description\n${task.description}\n`;
-    }
-    output += `\n---\n`;
-    output += `Created at: ${task.createdAt}\n`;
-    output += `\nYou can now use \`start_task\` with taskKey "${task.taskKey}" to begin working on it.`;
-    return {
-        content: [{ type: "text", text: output }],
-    };
-});
-// 15. Get project with GitHub info
+// 14. Get project with GitHub info
 server.registerTool("get_project", {
     description: "Get project details including linked GitHub repository",
     inputSchema: {

package/build/setup.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/setup.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as readline from 'readline';
+const CLAUDE_CONFIG_PATH = path.join(os.homedir(), '.claude.json');
+const OPENCODE_CONFIG_PATH = path.join(os.homedir(), 'opencode.json');
+// Colors for terminal output
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    green: '\x1b[32m',
+    blue: '\x1b[34m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+};
+function log(message, color = colors.reset) {
+    console.log(`${color}${message}${colors.reset}`);
+}
+function promptUser(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function setupClaude(authToken) {
+    log('\n📝 Setting up Claude Code configuration...', colors.blue);
+    const config = {
+        projora: {
+            command: 'npx',
+            args: ['-y', '@projora/mcp-server'],
+            env: {
+                PROJORA_AUTH_TOKEN: authToken,
+            },
+        },
+    };
+    let existingConfig = {};
+    // Read existing config if it exists
+    if (fs.existsSync(CLAUDE_CONFIG_PATH)) {
+        try {
+            const fileContent = fs.readFileSync(CLAUDE_CONFIG_PATH, 'utf-8');
+            existingConfig = JSON.parse(fileContent);
+            log('  ✓ Found existing Claude Code configuration', colors.green);
+        }
+        catch (error) {
+            log('  ⚠ Warning: Could not parse existing config, will create new one', colors.yellow);
+        }
+    }
+    // Merge the configs
+    const updatedConfig = {
+        ...existingConfig,
+        ...config,
+    };
+    // Write the updated config
+    try {
+        fs.writeFileSync(CLAUDE_CONFIG_PATH, JSON.stringify(updatedConfig, null, 2), 'utf-8');
+        log(`  ✓ Successfully updated ${CLAUDE_CONFIG_PATH}`, colors.green);
+        return true;
+    }
+    catch (error) {
+        log(`  ✗ Failed to write config: ${error}`, colors.red);
+        return false;
+    }
+}
+async function setupOpenCode(authToken) {
+    log('\n📝 Setting up OpenCode configuration...', colors.blue);
+    const mcpConfig = {
+        projora: {
+            type: 'local',
+            command: ['npx', '-y', '@projora/mcp-server'],
+            enabled: true,
+            environment: {
+                PROJORA_AUTH_TOKEN: authToken,
+            },
+        },
+    };
+    let existingConfig = {};
+    // Read existing config if it exists
+    if (fs.existsSync(OPENCODE_CONFIG_PATH)) {
+        try {
+            const fileContent = fs.readFileSync(OPENCODE_CONFIG_PATH, 'utf-8');
+            existingConfig = JSON.parse(fileContent);
+            log('  ✓ Found existing OpenCode configuration', colors.green);
+        }
+        catch (error) {
+            log('  ⚠ Warning: Could not parse existing config, will create new one', colors.yellow);
+        }
+    }
+    // Ensure mcp key exists
+    if (!existingConfig.mcp) {
+        existingConfig.mcp = {};
+    }
+    // Add/update Projora MCP config
+    existingConfig.mcp.projora = mcpConfig.projora;
+    // Write the updated config
+    try {
+        fs.writeFileSync(OPENCODE_CONFIG_PATH, JSON.stringify(existingConfig, null, 2), 'utf-8');
+        log(`  ✓ Successfully updated ${OPENCODE_CONFIG_PATH}`, colors.green);
+        return true;
+    }
+    catch (error) {
+        log(`  ✗ Failed to write config: ${error}`, colors.red);
+        return false;
+    }
+}
+async function main() {
+    log('\n╔═══════════════════════════════════════════╗', colors.bold);
+    log('║  Projora MCP Server Setup                ║', colors.bold);
+    log('╚═══════════════════════════════════════════╝', colors.bold);
+    log('\nThis wizard will configure Projora integration for your AI coding assistant.', colors.blue);
+    log('You can get your API token from: https://projora.app/settings/integrations\n');
+    // Prompt for auth token
+    const authToken = await promptUser('Enter your Projora API token: ');
+    if (!authToken) {
+        log('\n✗ Error: API token is required', colors.red);
+        process.exit(1);
+    }
+    // Ask which assistant to configure
+    log('\n' + colors.bold + 'Which AI coding assistant do you want to configure?' + colors.reset);
+    log('  1. Claude Code');
+    log('  2. OpenCode');
+    log('  3. Both');
+    const choice = await promptUser('\nEnter your choice (1, 2, or 3): ');
+    let claudeSuccess = false;
+    let opencodeSuccess = false;
+    switch (choice) {
+        case '1':
+            claudeSuccess = await setupClaude(authToken);
+            break;
+        case '2':
+            opencodeSuccess = await setupOpenCode(authToken);
+            break;
+        case '3':
+            claudeSuccess = await setupClaude(authToken);
+            opencodeSuccess = await setupOpenCode(authToken);
+            break;
+        default:
+            log('\n✗ Invalid choice', colors.red);
+            process.exit(1);
+    }
+    // Summary
+    log('\n' + colors.bold + '═'.repeat(45) + colors.reset);
+    log(colors.bold + 'Setup Complete!' + colors.reset, colors.green);
+    log('═'.repeat(45) + '\n', colors.bold);
+    if (claudeSuccess) {
+        log('✓ Claude Code is configured', colors.green);
+        log('  Restart Claude Code to start using Projora tools\n');
+    }
+    if (opencodeSuccess) {
+        log('✓ OpenCode is configured', colors.green);
+        log('  Restart OpenCode to start using Projora tools\n');
+    }
+    log('Available commands:', colors.blue);
+    log('  • start_task    - Start working on a task');
+    log('  • complete_task - Mark task as done');
+    log('  • my_tasks      - List your tasks');
+    log('  • add_comment   - Add a comment to a task');
+    log('  • log_time      - Log time worked');
+    log('  • search_tasks  - Search tasks\n');
+    log('Documentation: https://docs.projora.app/integrations/mcp\n');
+}
+main().catch((error) => {
+    log(`\n✗ Setup failed: ${error.message}`, colors.red);
+    process.exit(1);
+});

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@projora/mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for Projora task management - integrate with Claude Code and OpenCode to manage tasks, update statuses, and track work",
   "type": "module",
   "bin": {
-    "projora-mcp": "./build/index.js"
+    "projora-mcp": "./build/index.js",
+    "projora-mcp-setup": "./build/setup.js"
   },
   "main": "./build/index.js",
   "scripts": {
-    "build": "tsc && chmod 755 build/index.js",
+    "build": "tsc && chmod 755 build/index.js build/setup.js",
     "dev": "tsc --watch",
     "start": "node build/index.js",
+    "setup": "node build/setup.js",
     "prepublishOnly": "npm run build"
   },
   "files": [