MCP Documentation Service

Instructions

Implementation Reference

• src/handlers/documents.ts:372-419 (handler)

  Core implementation of the create_folder tool logic in the DocumentHandler class. Validates path, creates directory with fs.mkdir (recursive), and optionally creates a README.md file with frontmatter.

    async createFolder(
      folderPath: string,
      createReadme = true
    ): Promise<ToolResponse> {
      try {
        const validPath = await this.validatePath(folderPath);
  
        // Create the directory
        await fs.mkdir(validPath, { recursive: true });
  
        // Create a README.md file if requested
        if (createReadme) {
          const readmePath = path.join(validPath, "README.md");
          const folderName = path.basename(validPath);
          const content = `---
  title: ${folderName}
  description: Documentation for ${folderName}
  date: ${new Date().toISOString()}
  status: draft
  ---
  
  # ${folderName}
  
  This is the documentation for ${folderName}.
  `;
          await fs.writeFile(readmePath, content, "utf-8");
        }
  
        return {
          content: [
            { type: "text", text: `Successfully created folder: ${folderPath}` },
          ],
          metadata: {
            path: folderPath,
            readme: createReadme ? path.join(folderPath, "README.md") : null,
          },
        };
      } catch (error) {
        const errorMessage =
          error instanceof Error ? error.message : String(error);
        return {
          content: [
            { type: "text", text: `Error creating folder: ${errorMessage}` },
          ],
          isError: true,
        };
      }
    }

• src/schemas/tools.ts:64-67 (schema)

  Zod schema defining input validation for the create_folder tool: path (string, required), createReadme (boolean, default true). Extends ToolInputSchema.

  export const CreateFolderSchema = ToolInputSchema.extend({
    path: z.string(),
    createReadme: z.boolean().default(true),
  });

• src/index.ts:252-257 (registration)

  MCP tool registration for 'create_documentation_folder' (references create_folder in error messages), including description and input schema conversion.

    name: "create_documentation_folder",
    description:
      "Create a new folder in the docs directory. Optionally creates a README.md file " +
      "in the new folder with basic frontmatter.",
    inputSchema: zodToJsonSchema(CreateFolderSchema) as any,
  },

• src/index.ts:401-412 (registration)

  Dispatch handler in MCP server that parses arguments with CreateFolderSchema and delegates to documentHandler.createFolder method.

  case "create_documentation_folder": {
    const parsed = CreateFolderSchema.safeParse(args);
    if (!parsed.success) {
      throw new Error(
        `Invalid arguments for create_folder: ${parsed.error}`
      );
    }
    return await documentHandler.createFolder(
      parsed.data.path,
      parsed.data.createReadme
    );
  }