@segosolutions/mcp-server 1.0.0

package/dist/index.js

@@ -0,0 +1,478 @@
+#!/usr/bin/env node
+/**
+ * Sego PM MCP Server
+ *
+ * Model Context Protocol server for AI-assisted project management.
+ * Communicates with the Sego PM web application via HTTP API.
+ */
+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 { initializeApiClient, } from './api/client.js';
+import { resolveClaudeFile } from './lib/claude-file-resolver.js';
+import dotenv from 'dotenv';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Get the directory of this file
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load environment variables
+// Try multiple locations in order of precedence:
+// 1. Current working directory (user's project)
+// 2. Package root (for standalone package installation)
+dotenv.config(); // CWD first
+dotenv.config({ path: join(__dirname, '../../.env') }); // Package root fallback
+// Get configuration from environment
+const API_KEY = process.env.SEGO_API_KEY;
+const API_URL = process.env.SEGO_API_URL || 'http://localhost:3000';
+if (!API_KEY) {
+    console.error('Error: SEGO_API_KEY environment variable is required');
+    process.exit(1);
+}
+// API client and authenticated user
+let apiClient;
+let authenticatedUser;
+/**
+ * Initialize the MCP server by validating credentials with the API
+ */
+async function initialize() {
+    try {
+        // API_KEY is guaranteed to be defined here due to the check above
+        apiClient = initializeApiClient(API_URL, API_KEY);
+        const authResult = await apiClient.validateAuth();
+        authenticatedUser = authResult.user;
+        // Log environment configuration on startup
+        const isProduction = API_URL.includes('sego.pm') || API_URL.includes('vercel');
+        const environment = isProduction ? 'PRODUCTION' : 'DEVELOPMENT';
+        console.error('');
+        console.error('='.repeat(60));
+        console.error('Sego PM MCP Server - Environment Configuration');
+        console.error('='.repeat(60));
+        console.error(`Environment:    ${environment}`);
+        console.error(`API URL:        ${API_URL}`);
+        console.error(`Authenticated:  ${authenticatedUser.name} (${authenticatedUser.email})`);
+        console.error(`Projects:       ${authResult.projects.length} accessible`);
+        console.error('='.repeat(60));
+        console.error('');
+    }
+    catch (error) {
+        console.error('Failed to authenticate with API:', error);
+        process.exit(1);
+    }
+}
+// Create MCP server
+const server = new Server({
+    name: 'sego-pm',
+    version: '0.2.0', // Version bump for API-based implementation
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'get_my_tasks',
+                description: 'Get tasks assigned to you, optionally filtered by project or status. Returns a list of tasks with full details including acceptance criteria and technical notes.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        projectId: {
+                            type: 'string',
+                            description: 'Optional: Filter by project ID',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: [
+                                'AI_REVIEW',
+                                'DRAFT',
+                                'BACKLOG',
+                                'IN_PROGRESS',
+                                'IN_REVIEW',
+                                'BLOCKED',
+                                'COMPLETED',
+                                'CANCELLED',
+                            ],
+                            description: 'Optional: Filter by task status',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'search_tasks',
+                description: 'Search tasks by keyword in title, description, or technical notes. Returns tasks you have access to (assigned to you or created by you).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Search query (searches title, description, technical notes)',
+                        },
+                        projectId: {
+                            type: 'string',
+                            description: 'Optional: Limit search to specific project',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'update_task_status',
+                description: 'Update the status of a task. Validates status transitions to ensure workflow integrity. Optionally add a comment explaining the status change.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: {
+                            type: 'string',
+                            description: 'Task ID',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: [
+                                'AI_REVIEW',
+                                'DRAFT',
+                                'BACKLOG',
+                                'IN_PROGRESS',
+                                'IN_REVIEW',
+                                'BLOCKED',
+                                'COMPLETED',
+                                'CANCELLED',
+                            ],
+                            description: 'New status for the task',
+                        },
+                        comment: {
+                            type: 'string',
+                            description: 'Optional: Comment explaining the status change',
+                        },
+                    },
+                    required: ['taskId', 'status'],
+                },
+            },
+            {
+                name: 'add_task_comment',
+                description: 'Add a comment to a task. Useful for progress updates, questions, or completion notes. Supports markdown formatting.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: {
+                            type: 'string',
+                            description: 'Task ID',
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Comment content (supports markdown)',
+                        },
+                    },
+                    required: ['taskId', 'content'],
+                },
+            },
+            {
+                name: 'assign_task',
+                description: 'Assign a task to a user. If no assignToUserId is provided, assigns the task to yourself.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: {
+                            type: 'string',
+                            description: 'Task ID',
+                        },
+                        assignToUserId: {
+                            type: 'string',
+                            description: 'Optional: User ID to assign the task to. If not provided, assigns to yourself.',
+                        },
+                    },
+                    required: ['taskId'],
+                },
+            },
+            {
+                name: 'get_client_request',
+                description: 'Get a client request with all associated tasks and full context. Includes task details, comments, project information, and progress summary.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        requestId: {
+                            type: 'string',
+                            description: 'Client request ID',
+                        },
+                    },
+                    required: ['requestId'],
+                },
+            },
+            {
+                name: 'search_client_requests',
+                description: 'Search client requests by project, status, or keyword. Returns requests with task summaries and counts.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        projectId: {
+                            type: 'string',
+                            description: 'Optional: Filter by project ID',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['PENDING_AI', 'PENDING_REVIEW', 'APPROVED', 'REJECTED'],
+                            description: 'Optional: Filter by request status',
+                        },
+                        query: {
+                            type: 'string',
+                            description: 'Optional: Search keyword in description, raw content, or AI analysis',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'create_project_from_codebase',
+                description: 'Create a Sego PM project from a local codebase with CLAUDE.md file. ' +
+                    'Automatically extracts project name, description, and tech stack from CLAUDE.md, ' +
+                    'stores the full content as project knowledge base, and sets you as project owner. ' +
+                    'Will auto-detect CLAUDE.md in current directory or .claude/ subdirectory, or you can provide explicit path.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        claudePath: {
+                            type: 'string',
+                            description: 'Optional explicit path to CLAUDE.md file. If not provided, will auto-detect.',
+                        },
+                        baseDir: {
+                            type: 'string',
+                            description: 'Optional base directory for file resolution. Defaults to current working directory.',
+                        },
+                        projectNameOverride: {
+                            type: 'string',
+                            description: 'Optional override for project name if auto-extraction fails or you want different name.',
+                        },
+                        monthlyHours: {
+                            type: 'number',
+                            description: 'Monthly hour allocation (default: 40)',
+                            default: 40,
+                        },
+                        hourlyRate: {
+                            type: 'number',
+                            description: 'Hourly rate (default: 0, can be set later)',
+                            default: 0,
+                        },
+                    },
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case 'get_my_tasks': {
+                const tasks = await apiClient.getTasks({
+                    projectId: args?.projectId,
+                    status: args?.status,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(tasks, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'search_tasks': {
+                if (!args?.query) {
+                    throw new Error('query parameter is required');
+                }
+                const result = await apiClient.searchTasks(args.query, args?.projectId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result.tasks, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'update_task_status': {
+                if (!args?.taskId || !args?.status) {
+                    throw new Error('taskId and status parameters are required');
+                }
+                const result = await apiClient.updateTask(args.taskId, {
+                    status: args.status,
+                    comment: args?.comment,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result.task, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'add_task_comment': {
+                if (!args?.taskId || !args?.content) {
+                    throw new Error('taskId and content parameters are required');
+                }
+                const result = await apiClient.addTaskComment(args.taskId, args.content);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result.comment, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'assign_task': {
+                if (!args?.taskId) {
+                    throw new Error('taskId parameter is required');
+                }
+                // Use 'me' to assign to self if no user specified
+                const assignToUserId = args?.assignToUserId;
+                const result = await apiClient.updateTask(args.taskId, {
+                    assignedToId: assignToUserId || 'me',
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result.task, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'create_project_from_codebase': {
+                // Read the local CLAUDE.md file
+                const resolvedFile = await resolveClaudeFile({
+                    explicitPath: args?.claudePath,
+                    baseDir: args?.baseDir,
+                });
+                // Send content to API
+                const result = await apiClient.createProjectFromCodebase({
+                    content: resolvedFile.content,
+                    projectName: args?.projectNameOverride,
+                    monthlyHours: args?.monthlyHours || 40,
+                    hourlyRate: args?.hourlyRate || 0,
+                    claudeFilePath: resolvedFile.path,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_client_request': {
+                if (!args?.requestId) {
+                    throw new Error('requestId parameter is required');
+                }
+                const result = await apiClient.getClientRequest(args.requestId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'search_client_requests': {
+                const result = await apiClient.searchClientRequests({
+                    projectId: args?.projectId,
+                    status: args?.status,
+                    query: args?.query,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result.requests, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// List available resources
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: 'sego://tasks/{taskId}',
+                name: 'Task Detail',
+                description: 'Get detailed information about a specific task including comments and full context',
+                mimeType: 'application/json',
+            },
+            {
+                uri: 'sego://client-requests/{requestId}',
+                name: 'Client Request Detail',
+                description: 'Get detailed information about a client request including all associated tasks, comments, and project context',
+                mimeType: 'application/json',
+            },
+        ],
+    };
+});
+// Handle resource reads
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    // Parse task detail URI: sego://tasks/{taskId}
+    const taskMatch = uri.match(/^sego:\/\/tasks\/(.+)$/);
+    if (taskMatch) {
+        const taskId = taskMatch[1];
+        const task = await apiClient.getTask(taskId);
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(task, null, 2),
+                },
+            ],
+        };
+    }
+    // Parse client request detail URI: sego://client-requests/{requestId}
+    const clientRequestMatch = uri.match(/^sego:\/\/client-requests\/(.+)$/);
+    if (clientRequestMatch) {
+        const requestId = clientRequestMatch[1];
+        const clientRequest = await apiClient.getClientRequest(requestId);
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(clientRequest, null, 2),
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+});
+// Start server
+async function main() {
+    await initialize();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Sego PM MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/claude-file-resolver.d.ts

@@ -0,0 +1,74 @@
+/**
+ * CLAUDE.md File Resolver Service
+ *
+ * Handles secure file path resolution and CLAUDE.md file discovery
+ * with path traversal prevention and validation.
+ */
+export interface FileResolverOptions {
+    explicitPath?: string;
+    baseDir?: string;
+    searchDirs?: string[];
+}
+export interface ResolvedFile {
+    path: string;
+    content: string;
+    foundMethod: 'explicit' | 'auto-detect';
+    sizeBytes: number;
+}
+/**
+ * Resolve and read CLAUDE.md file
+ *
+ * @param options - Resolution options
+ * @returns Resolved file with content and metadata
+ * @throws Error if file not found or validation fails
+ *
+ * @example
+ * // Auto-detect
+ * const file = await resolveClaudeFile()
+ *
+ * @example
+ * // Explicit path
+ * const file = await resolveClaudeFile({ explicitPath: 'docs/CLAUDE.md' })
+ */
+export declare function resolveClaudeFile(options?: FileResolverOptions): Promise<ResolvedFile>;
+/**
+ * Resolve explicit path with security checks
+ *
+ * Prevents path traversal attacks by ensuring the resolved path
+ * stays within the allowed baseDir.
+ *
+ * @param explicitPath - User-provided file path
+ * @param baseDir - Base directory to restrict access to
+ * @returns Absolute path to file
+ * @throws Error if path is invalid or escapes baseDir
+ */
+export declare function resolveExplicitPath(explicitPath: string, baseDir: string): Promise<string>;
+/**
+ * Auto-detect CLAUDE.md in common locations
+ *
+ * Searches for CLAUDE.md in standard locations:
+ * 1. ./CLAUDE.md
+ * 2. ./.claude/CLAUDE.md
+ * 3. ./claude.md (lowercase variant)
+ * 4. ./.claude/claude.md
+ *
+ * @param baseDir - Base directory to search from
+ * @param additionalDirs - Additional directories to search
+ * @returns Absolute path to CLAUDE.md or null if not found
+ */
+export declare function autoDetectClaudeFile(baseDir: string, additionalDirs?: string[]): Promise<string | null>;
+/**
+ * Get relative path for display purposes
+ *
+ * @param absolutePath - Absolute path to file
+ * @param baseDir - Base directory (defaults to CWD)
+ * @returns Relative path from baseDir
+ */
+export declare function getDisplayPath(absolutePath: string, baseDir?: string): string;
+export declare class SecurityError extends Error {
+    constructor(message: string);
+}
+export declare class ClaudeFileNotFoundError extends Error {
+    constructor(searchedPaths: string[]);
+}
+//# sourceMappingURL=claude-file-resolver.d.ts.map

package/dist/lib/claude-file-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-file-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/claude-file-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,UAAU,GAAG,aAAa,CAAA;IACvC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CAkCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB;AAmBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7E;AAID,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,aAAa,EAAE,MAAM,EAAE;CAWpC"}