Enhanced Directory Context MCP Server

Instructions

Implementation Reference

• server.js:602-636 (handler)

  The main handler function for 'append_to_file' tool. Reads existing file content if it exists, optionally adds a newline before appending new content, writes the updated content back to the file, and returns a success message.

  async handleAppendToFile(args) {
    const { path: filePath, content, newline_before = true } = args;
    const fullPath = path.resolve(this.workingDirectory, filePath);
    
    try {
      // Check if file exists
      let existingContent = '';
      try {
        existingContent = await fs.readFile(fullPath, 'utf8');
      } catch (error) {
        // File doesn't exist, will be created
      }
      
      // Prepare content to append
      let finalContent = existingContent;
      if (existingContent && newline_before && !existingContent.endsWith('\n')) {
        finalContent += '\n';
      }
      finalContent += content;
      
      // Write file
      await fs.writeFile(fullPath, finalContent, 'utf8');
      
      return {
        content: [
          {
            type: 'text',
            text: `Content appended to file: ${filePath}`,
          },
        ],
      };
    } catch (error) {
      throw new McpError(ErrorCode.InternalError, `Failed to append to file: ${error.message}`);
    }
  }

• server.js:256-274 (schema)

  Input schema definition for the 'append_to_file' tool, specifying parameters: path (required), content (required), and newline_before (optional boolean with default true).

  inputSchema: {
    type: 'object',
    properties: {
      path: {
        type: 'string',
        description: 'File path relative to working directory',
      },
      content: {
        type: 'string',
        description: 'Content to append',
      },
      newline_before: {
        type: 'boolean',
        description: 'Add newline before appending',
        default: true,
      },
    },
    required: ['path', 'content'],
  },

• server.js:479-480 (registration)

  Switch case in the tool call handler that registers and dispatches 'append_to_file' calls to the handleAppendToFile method.

  case 'append_to_file':
    return await this.handleAppendToFile(args);

• server.js:253-275 (registration)

  Tool registration in the ListTools response, defining name, description, and input schema for 'append_to_file'.

  {
    name: 'append_to_file',
    description: 'Append content to the end of a file',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'File path relative to working directory',
        },
        content: {
          type: 'string',
          description: 'Content to append',
        },
        newline_before: {
          type: 'boolean',
          description: 'Add newline before appending',
          default: true,
        },
      },
      required: ['path', 'content'],
    },
  },

• server.js:750-750 (helper)

  Usage of handleAppendToFile in the batch_file_operations tool for 'append' operation.

  result = await this.handleAppendToFile(params);