Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/initiatives.ts:495-503 (handler)

  The primary handler function for the 'get_enhanced_project_context' MCP tool. Validates project_id input using Zod, logs the request, fetches enhanced project context via supabaseService, and returns the context.

  export const getEnhancedProjectContext = requireAuth(async (args: any) => {
    const { project_id } = z.object({ project_id: z.string().uuid() }).parse(args)
    
    logger.info('Getting enhanced project context', { project_id })
    
    const context = await supabaseService.getEnhancedProjectContext(project_id)
    
    return { context }
  })

• src/tools/initiatives.ts:479-493 (registration)

  Tool registration definition exporting the MCPTool object with name, description, and input schema specifying required project_id (UUID format).

  export const getEnhancedProjectContextTool: MCPTool = {
    name: 'get_enhanced_project_context',
    description: 'Get project context including all initiatives',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: {
          type: 'string',
          format: 'uuid',
          description: 'The unique identifier of the project'
        }
      },
      required: ['project_id']
    }
  }

• src/tools/initiatives.ts:496-502 (schema)

  Zod schema validation within the handler for input argument parsing, ensuring project_id is a valid UUID.

  const { project_id } = z.object({ project_id: z.string().uuid() }).parse(args)
  
  logger.info('Getting enhanced project context', { project_id })
  
  const context = await supabaseService.getEnhancedProjectContext(project_id)
  
  return { context }

• src/lib/api-client.ts:593-596 (helper)

  Supporting API client method (supabaseService.getEnhancedProjectContext) called by the handler, which makes an authenticated request to the backend /api/mcp/projects/{projectId}/context-enhanced endpoint.

  async getEnhancedProjectContext(projectId: string): Promise<any> {
    const response = await this.request<{ context: any }>(`/api/mcp/projects/${projectId}/context-enhanced`)
    return response.context
  }

• src/tools/initiatives.ts:630-642 (registration)

  Maps the tool name 'get_enhanced_project_context' to its handler function in the exported initiativeHandlers object, likely used for global tool registration.

  export const initiativeHandlers = {
    list_initiatives: listInitiatives,
    get_initiative: getInitiative,
    create_initiative: createInitiative,
    update_initiative: updateInitiative,
    get_initiative_context: getInitiativeContext,
    get_initiative_insights: getInitiativeInsights,
    search_workspace: searchWorkspace,
    get_enhanced_project_context: getEnhancedProjectContext,
    get_workspace_context: getWorkspaceContext,
    associate_document_with_initiative: associateDocumentWithInitiative,
    disassociate_document_from_initiative: disassociateDocumentFromInitiative
  }