MCP File Context Server

Instructions

Implementation Reference

• src/index.ts:1375-1427 (handler)

  The handler function for the 'getFiles' tool. It processes a list of file paths, validates access for each, reads metadata and content, handles individual file errors without failing the entire request, and returns a JSON response with file details including content, size, and last modified time.

  private async handleGetFiles(args: any) {
      const { filePathList } = args;
      await this.loggingService.debug('Getting files', {
          fileCount: filePathList?.length || 0,
          operation: 'get_files'
      });
  
      if (!Array.isArray(filePathList)) {
          throw new McpError(ErrorCode.InvalidParams, 'filePathList must be an array');
      }
  
      const results: any[] = [];
  
      // Process each file, handling errors gracefully
      for (const fileItem of filePathList) {
          const filePath = fileItem.fileName;
          
          try {
              // PATTERN: Use existing security validation
              const resolvedPath = await this.validateAccess(filePath);
              
              // PATTERN: Use existing file reading methods
              const metadata = await this.getFileMetadata(resolvedPath);
              const { content } = await this.readFileWithEncoding(resolvedPath, 'utf8');
              
              // TRANSFORM: Match required response schema
              results.push({
                  fileName: filePath,
                  content: content,
                  fileSize: metadata.size,
                  lastModifiedDateTime: metadata.modifiedTime
              });
          } catch (error) {
              // GOTCHA: Don't fail entire request - log error and continue
              await this.loggingService.error('Error reading file', error as Error, {
                  filePath,
                  operation: 'get_files'
              });
              
              // Include error info in response but continue processing
              results.push({
                  fileName: filePath,
                  content: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
                  fileSize: 0,
                  lastModifiedDateTime: new Date().toISOString()
              });
          }
      }
  
      // PATTERN: Use existing response format method
      return this.createJsonResponse(results);
  }

• src/index.ts:1559-1583 (registration)

  Registration of the 'getFiles' tool in the ListTools response, including name, description, and input schema definition.

  {
      name: 'getFiles',
      description: 'Retrieve multiple files by their paths, returning content and metadata for each file',
      inputSchema: {
          type: 'object',
          properties: {
              filePathList: {
                  type: 'array',
                  description: 'The list of file paths for the file content to return.',
                  minItems: 1,
                  items: {
                      type: 'object',
                      properties: {
                          fileName: {
                              type: 'string',
                              description: 'Path and file name for the file to be retrieved.'
                          }
                      },
                      required: ['fileName']
                  }
              }
          },
          required: ['filePathList']
      }
  }

• src/index.ts:1619-1620 (registration)

  Registration of the 'getFiles' tool handler in the CallToolRequestSchema switch statement.

  case 'getFiles':
      return await this.handleGetFiles(request.params.arguments);