Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/projects.ts:203-216 (handler)

  Core handler function that validates input using UpdateProjectSchema, logs the update attempt, calls supabaseService.updateProject to perform the database update, logs success, and returns the updated project object with a confirmation message.

  export const updateProject = requireAuth(async (args: any) => {
    const { project_id, ...updates } = UpdateProjectSchema.parse(args)
    
    logger.info('Updating project', { project_id, updates })
    
    const project = await supabaseService.updateProject(project_id, updates)
    
    logger.info('Project updated successfully', { project_id: project.id })
    
    return {
      project,
      message: `Project "${project.name}" updated successfully`
    }
  })

• src/tools/projects.ts:30-36 (schema)

  Zod schema defining the input structure for the update_project tool, validating project_id as UUID and optional fields for name, description, and status.

  const UpdateProjectSchema = z.object({
    project_id: z.string().uuid(),
    name: z.string().min(1).max(255).optional(),
    description: z.string().optional(),
    status: z.enum(['active', 'completed', 'archived']).optional(),
    // Removed priority, metadata as they don't exist in the database schema
  })

• src/tools/projects.ts:171-201 (registration)

  MCPTool object registration defining the 'update_project' tool with its name, description, and JSON input schema compatible with the MCP protocol.

  export const updateProjectTool: MCPTool = {
    name: 'update_project',
    description: 'Update an existing project with new information',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: {
          type: 'string',
          format: 'uuid',
          description: 'The unique identifier of the project to update'
        },
        name: {
          type: 'string',
          minLength: 1,
          maxLength: 255,
          description: 'New name for the project'
        },
        description: {
          type: 'string',
          description: 'New description for the project'
        },
        status: {
          type: 'string',
          enum: ['active', 'completed', 'archived'],
          description: 'New status for the project'
        },
        // Removed priority, metadata as they don't exist in the database schema
      },
      required: ['project_id']
    }
  }

• src/tools/projects.ts:778-788 (registration)

  Export of projectHandlers object that maps tool names to their handler functions, including 'update_project: updateProject', used for MCP tool registration.

  export const projectHandlers = {
    list_projects: listProjects,
    get_project: getProject,
    create_project: createProject,
    update_project: updateProject,
    get_project_context: getProjectContext,
    archive_project: archiveProject,
    duplicate_project: duplicateProject,
    get_project_timeline: getProjectTimeline,
    bulk_update_projects: bulkUpdateProjects
  }

• src/lib/api-client.ts:391-398 (helper)

  supabaseService.updateProject helper method that makes an authenticated PATCH request to the backend API endpoint /api/mcp/projects/{projectId} to update the project data.

  async updateProject(projectId: string, updates: Partial<Project>): Promise<Project> {
    const response = await this.request<{ project: Project }>(`/api/mcp/projects/${projectId}`, {
      method: 'PATCH',
      body: JSON.stringify(updates),
    })
    
    return response.project
  }