@pimzino/agentic-tools-mcp/dist/features/task-management/tools/projects/get.js

A comprehensive MCP server for task management and agent memories with JSON file storage

import { z } from 'zod';
/**
 * Get project details by ID
 *
 * @param storage - Storage instance
 * @returns MCP tool handler for getting project details
 */
export function createGetProjectTool(storage) {
    return {
        name: 'get_project',
        description: 'Get detailed information about a specific project by its ID',
        inputSchema: {
            id: z.string()
        },
        handler: async ({ id }) => {
            try {
                // Validate input
                if (!id || id.trim().length === 0) {
                    return {
                        content: [{
                                type: 'text',
                                text: 'Error: Project ID is required.'
                            }],
                        isError: true
                    };
                }
                const project = await storage.getProject(id.trim());
                if (!project) {
                    return {
                        content: [{
                                type: 'text',
                                text: `Error: Project with ID "${id}" not found. Use list_projects to see all available projects.`
                            }],
                        isError: true
                    };
                }
                // Get related tasks and subtasks for summary
                const tasks = await storage.getTasks(project.id);
                const completedTasks = tasks.filter(t => t.completed).length;
                let subtaskSummary = '';
                if (tasks.length > 0) {
                    const allSubtasks = await storage.getSubtasks(undefined, project.id);
                    const completedSubtasks = allSubtasks.filter(s => s.completed).length;
                    subtaskSummary = `\nSubtasks: ${completedSubtasks}/${allSubtasks.length} completed`;
                }
                return {
                    content: [{
                            type: 'text',
                            text: `**${project.name}** (ID: ${project.id})

**Description:** ${project.description}

**Created:** ${new Date(project.createdAt).toLocaleString()}
**Last Updated:** ${new Date(project.updatedAt).toLocaleString()}

**Progress Summary:**
Tasks: ${completedTasks}/${tasks.length} completed${subtaskSummary}

Use list_tasks with projectId="${project.id}" to see all tasks in this project.`
                        }]
                };
            }
            catch (error) {
                return {
                    content: [{
                            type: 'text',
                            text: `Error retrieving project: ${error instanceof Error ? error.message : 'Unknown error'}`
                        }],
                    isError: true
                };
            }
        }
    };
}