Word Document MCP Server

Instructions

Implementation Reference

• src/services/document-manager.ts:134-149 (handler)

  Core implementation of the addNumberedList method that creates docx Paragraph elements with numbering configuration and appends them to the document's paragraphs array.

  addNumberedList(docId: string, items: string[]): void {
    const docInfo = this.getDocument(docId);
  
    items.forEach((item, index) => {
      const paragraph = new Paragraph({
        text: item,
        numbering: {
          reference: "default-numbering",
          level: 0,
        },
      });
      docInfo.paragraphs.push(paragraph);
    });
  
    this.updateDocument(docId);
  }

• src/tools/tool-handlers.ts:51-60 (handler)

  Tool call handler case within handleToolCall that invokes the documentManager's addNumberedList method and returns a success confirmation.

  case "add_numbered_list":
    documentManager.addNumberedList(args.docId, args.items);
    return {
      content: [
        {
          type: "text",
          text: `Numbered list added with ${args.items.length} items.`,
        },
      ],
    };

• src/tools/document-tools.ts:99-117 (schema)

  Defines the tool schema for 'add_numbered_list' including input validation for docId (string) and items (string array).

  {
    name: "add_numbered_list",
    description: "Add a numbered list to the document",
    inputSchema: {
      type: "object",
      properties: {
        docId: {
          type: "string",
          description: "Document identifier",
        },
        items: {
          type: "array",
          items: { type: "string" },
          description: "Array of list items",
        },
      },
      required: ["docId", "items"],
    },
  },

• src/index.ts:24-28 (registration)

  MCP server registration of tools list via ListToolsRequestHandler, where documentTools array includes the 'add_numbered_list' tool definition.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: documentTools,
    };
  });