doc-tools-mcp

Implementation Reference

• src/mcp-server.ts:21-47 (handler)

  The handler function for the MCP 'create_document' tool. It processes the parameters, calls the DocumentService to create the document, handles errors, and returns an MCP-compatible response with content and isError flag.

  }, async (params) => {
    try {
      const result = await docService.createDocument(params.filePath, {
        title: params.title,
        author: params.author,
      });
      return {
        content: [
          {
            type: "text",
            text: result.success ? `文档已创建: ${params.filePath}` : result.error!,
          },
        ],
        isError: !result.success,
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text",
            text: `创建文档失败: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  });

• src/mcp-server.ts:17-20 (schema)

  Zod-based input schema definition for the 'create_document' tool parameters in the MCP server registration.

  server.tool("create_document", {
    filePath: z.string(),
    title: z.string().optional(),
    author: z.string().optional(),

• src/mcp-server.ts:17-47 (registration)

  Full registration of the 'create_document' tool on the MCP server using McpServer.tool(), including schema and handler.

  server.tool("create_document", {
    filePath: z.string(),
    title: z.string().optional(),
    author: z.string().optional(),
  }, async (params) => {
    try {
      const result = await docService.createDocument(params.filePath, {
        title: params.title,
        author: params.author,
      });
      return {
        content: [
          {
            type: "text",
            text: result.success ? `文档已创建: ${params.filePath}` : result.error!,
          },
        ],
        isError: !result.success,
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text",
            text: `创建文档失败: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  });

• src/services/DocumentService.ts:27-52 (helper)

  The core helper function in DocumentService that performs the actual document creation using the docx library, sets metadata, packs to buffer, and writes to the specified file path.

  async createDocument(filePath: string, options?: DocumentCreateOptions): Promise<APIResponse> {
    try {
      const doc = new Document({
        sections: [{
          properties: {},
          children: [new Paragraph({
            text: '',
            style: 'Normal'
          })]
        }],
        title: options?.title,
        subject: options?.subject,
        creator: options?.author,
        keywords: options?.keywords?.join(','),
      });
  
      await Packer.toBuffer(doc).then((buffer) => {
        return fs.writeFile(filePath, buffer);
      });
  
      return { success: true, data: { filePath } };
    } catch (error) {
      const err = error as Error;
      return { success: false, error: `创建文档失败: ${err.message}` };
    }
  }

• src/server.ts:14-26 (schema)

  JSON schema for the 'create_document' tool parameters defined in the HTTP server's tools list.

  {
    name: 'create_document',
    description: '创建新的 Word 文档',
    parameters: {
      properties: {
        filePath: { type: 'string', description: '文档保存路径' },
        title: { type: 'string', description: '文档标题' },
        author: { type: 'string', description: '文档作者' },
      },
      required: ['filePath'],
      type: 'object',
    },
  },