Statelessor MCP Server

Instructions

Implementation Reference

• tools/analyze-local.js:23-70 (handler)

  The execute function implements the core logic: validates project path, zips the directory using projectZipper, calls the Statelessor API via apiClient, formats the result, handles errors, and cleans up the temporary ZIP file.

  async execute(args) {
    let zipFilePath = null;
  
    try {
      const { projectPath } = args;
  
      // Validate project path
      const stats = await fs.stat(projectPath);
      if (!stats.isDirectory()) {
        throw new Error('Project path must be a directory');
      }
  
      // ZIP the project
      zipFilePath = await projectZipper.zipProject(projectPath);
  
      // Call Statelessor API
      const result = await apiClient.analyzeLocalProject(zipFilePath);
  
      // Format result for Amazon Q
      return {
        content: [
          {
            type: 'text',
            text: resultFormatter.formatAnalysisResult(result),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error analyzing local project: ${error.message}`,
          },
        ],
        isError: true,
      };
    } finally {
      // Cleanup ZIP file
      if (zipFilePath) {
        try {
          await fs.unlink(zipFilePath);
        } catch (err) {
          console.error('Failed to cleanup ZIP file:', err);
        }
      }
    }
  },

• tools/analyze-local.js:8-21 (schema)

  The tool definition object, including name, description, and inputSchema specifying the required 'projectPath' parameter.

  definition: {
    name: 'analyze_local_project',
    description: 'Analyze a local project directory for stateful code patterns',
    inputSchema: {
      type: 'object',
      properties: {
        projectPath: {
          type: 'string',
          description: 'Absolute path to project directory',
        },
      },
      required: ['projectPath'],
    },
  },

• mcp-server.js:57-58 (registration)

  Registration in the MCP server switch statement: dispatches tool calls to analyzeLocalTool.execute.

  case 'analyze_local_project':
    return await analyzeLocalTool.execute(args);

• mcp-server.js:42-42 (registration)

  Tool definition registered in the ListToolsRequestHandler response.

  analyzeLocalTool.definition,

• utils/api-client.js:57-76 (helper)

  API client method that sends the ZIP file to the Statelessor /analyze endpoint for processing.

  async analyzeLocalProject(zipFilePath) {
    const requestId = this.generateRequestId();
    
    try {
      const formData = new FormData();
      formData.append('type', 'zip');
      formData.append('zipFile', fs.createReadStream(zipFilePath));  // Changed from 'file' to 'zipFile'
  
      const response = await this.client.post('/analyze', formData, {
        headers: {
          'X-Request-ID': requestId,
          ...formData.getHeaders(),
        },
      });
  
      return response.data;
    } catch (error) {
      throw this.handleError(error, 'analyzeLocalProject');
    }
  }