Word Tools MCP Server
A Model Context Protocol (MCP) server that provides AI-powered Word document manipulation capabilities. This server implements the MCP protocol to enable AI applications to create, edit, and manage Word documents through natural language interactions.
[](https://smithery.ai/server/@puchunjie/doc-tools)
Features
- Full MCP protocol implementation
- Word document creation and management
- Rich text content manipulation
- Table creation and formatting
- Document layout control
- Document metadata management
- Real-time document state monitoring
Prerequisites
- Node.js 14 or higher
- Microsoft Word (optional, for advanced features)
Installation
Or install globally:
For use as a dependency in your project:
Usage
- Start the MCP server:
- The server will start on port 8765 by default
- Configure your AI application (e.g., Cursor, VSCode) to use the MCP server: ``` http://localhost:8765 ```
MCP Tools
The server provides the following MCP functions:
- `create_document` - Create a new Word document - Parameters: filePath (required), title, author
- `open_document` - Open an existing Word document - Parameters: filePath (required)
- `add_paragraph` - Add a paragraph to the document - Parameters: filePath (required), text (required), style, alignment
- `add_table` - Add a table to the document - Parameters: filePath (required), rows (required), cols (required), headers, data
- `search_and_replace` - Find and replace text in the document - Parameters: filePath (required), searchText (required), replaceText (required), matchCase
- `set_page_margins` - Set document page margins - Parameters: filePath (required), top, right, bottom, left
- `get_document_info` - Get document metadata - Parameters: filePath (required)
Integration with AI Applications
Cursor
- Open the Cursor configuration file `~/.cursor/mcp.json`
- Add the following configuration:
Or for local development version:
After configuration, you can use natural language to manipulate Word documents:
VSCode and Other MCP-Compatible Tools
Similar integration steps apply to other tools that support the MCP protocol. Consult your tool's documentation for specific MCP server configuration steps.
Development
To extend or modify this MCP server:
- Clone the repository:
- Install dependencies:
- Start in development mode:
- Build for production:
Adding New MCP Functions
- Add new methods in `src/services/DocumentService.ts`
- Register new functions in `src/mcp-server.ts`
- Update type definitions as needed
Configuration
- Default port: 8765 (configurable)
- Supported file types: .docx
- All file paths should be absolute or relative to the current working directory
License
MIT
Support
If you encounter any issues or have suggestions for improvements, please submit an issue on our GitHub repository.