@projora/mcp-server 1.1.0 → 1.3.0

package/README.md

@@ -32,18 +32,27 @@ Or install globally:
 npm install -g @projora/mcp-server
 ```
 
-## Configuration
+## Quick Setup
 
-The server requires two environment variables:
+Run this single command to automatically configure Claude Code or OpenCode:
 
-- `PROJORA_GRAPHQL_URL` - Your Projora GraphQL endpoint (defaults to `https://api.projora.app/graphql`)
-- `PROJORA_AUTH_TOKEN` - Your API token from Projora
+```bash
+npx @projora/mcp-server setup
+```
+
+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
 {
@@ -56,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
 {
@@ -75,8 +86,12 @@ 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
 

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.1.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": [