doc-tools-mcp
Servidor MCP de herramientas de Word
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de manipulación de documentos de Word basadas en IA. Este servidor implementa el protocolo MCP para que las aplicaciones de IA puedan crear, editar y gestionar documentos de Word mediante interacciones de lenguaje natural.
Características
Implementación completa del protocolo MCP
Creación y gestión de documentos de Word
Manipulación de contenido de texto enriquecido
Creación y formato de tablas
Control del diseño del documento
Gestión de metadatos de documentos
Monitoreo del estado de los documentos en tiempo real
Related MCP server: MCP Word Commander
Prerrequisitos
Node.js 14 o superior
Microsoft Word (opcional, para funciones avanzadas)
Instalación
npx @puchunjie/doc-tools-mcpO instalar globalmente:
npm install -g @puchunjie/doc-tools-mcpPara utilizar como dependencia en su proyecto:
npm install @puchunjie/doc-tools-mcpUso
Inicie el servidor MCP:
npx @puchunjie/doc-tools-mcpEl servidor se iniciará en el puerto 8765 de forma predeterminada
Configure su aplicación de IA (por ejemplo, Cursor, VSCode) para usar el servidor MCP:
http://localhost:8765
Herramientas MCP
El servidor proporciona las siguientes funciones MCP:
create_document- Crea un nuevo documento de WordParámetros: filePath (obligatorio), título, autor
open_document- Abre un documento de Word existenteParámetros: filePath (obligatorio)
add_paragraph- Agrega un párrafo al documentoParámetros: filePath (obligatorio), texto (obligatorio), estilo, alineación
add_table- Agrega una tabla al documentoParámetros: filePath (obligatorio), filas (obligatorio), columnas (obligatorio), encabezados, datos
search_and_replace- Buscar y reemplazar texto en el documentoParámetros: filePath (obligatorio), searchText (obligatorio), replaceText (obligatorio), matchCase
set_page_margins- Establecer los márgenes de página del documentoParámetros: filePath (obligatorio), arriba, derecha, abajo, izquierda
get_document_info- Obtener metadatos del documentoParámetros: filePath (obligatorio)
Integración con aplicaciones de IA
Cursor
Abra el archivo de configuración del cursor
~/.cursor/mcp.jsonAgregue la siguiente configuración:
{
"mcpServers": {
"doc-tools-mcp": {
"command": "npx",
"args": [
"@puchunjie/doc-tools-mcp"
]
}
}
}
O para la versión de desarrollo local:
{
"mcpServers": {
"doc-tools-mcp": {
"command": "node",
"args": [
"/path/to/your/doc-tools-mcp/dist/mcp-server.js"
]
}
}
}Después de la configuración, puede utilizar lenguaje natural para manipular documentos de Word:
"Create a new document named report.docx"
"Add a heading 'Monthly Report' to report.docx"
"Insert a 4x3 table with sales data"VSCode y otras herramientas compatibles con MCP
Se aplican pasos de integración similares a otras herramientas compatibles con el protocolo MCP. Consulte la documentación de su herramienta para conocer los pasos específicos de configuración del servidor MCP.
Desarrollo
Para ampliar o modificar este servidor MCP:
Clonar el repositorio:
git clone <repository-url>
cd doc-tools-mcpInstalar dependencias:
npm installIniciar en modo de desarrollo:
npm run startConstruir para producción:
npm run buildAgregar nuevas funciones MCP
Agregar nuevos métodos en
src/services/DocumentService.tsRegistrar nuevas funciones en
src/mcp-server.tsActualice las definiciones de tipos según sea necesario
Configuración
Puerto predeterminado: 8765 (configurable)
Tipos de archivos admitidos: .docx
Todas las rutas de archivos deben ser absolutas o relativas al directorio de trabajo actual
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Apoyo
Si encuentra algún problema o tiene sugerencias para mejorar, envíe un problema en nuestro repositorio de GitHub.
Available Tools
7 toolsadd_paragraphD
Inputs: filePath (required), text (required), style, alignment.
add_tableD
Inputs: filePath (required), rows (required), cols (required), headers, +1 more.
create_documentD
Inputs: filePath (required), title, author.
get_document_infoD
Inputs: filePath (required).
open_documentD
Inputs: filePath (required).
search_and_replaceD
Inputs: filePath (required), searchText (required), replaceText (required), matchCase.
set_page_marginsD
Inputs: filePath (required), top, right, bottom, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The tools have clearly distinct purposes targeting different document operations: creating documents, opening them, adding content (paragraphs/tables), modifying content (search/replace), adjusting layout (margins), and retrieving metadata. There is minor potential overlap between 'create_document' and 'open_document' if 'open' implies creation, but they are generally distinct.
All tool names follow a consistent verb_noun pattern with snake_case throughout (e.g., add_paragraph, create_document, get_document_info). There are no deviations in naming conventions, making the set predictable and readable.
With 7 tools, this is a well-scoped set for a document management server. It covers core operations without being overly sparse or bloated, aligning with typical tool counts for focused domains like this.
The tools cover creation, opening, content addition, basic editing, layout adjustment, and info retrieval, but there are notable gaps. Missing operations include updating or deleting documents, managing document versions, or handling more complex formatting, which could limit agent workflows in a document management context.
Maintenance
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Create and manage documents, spreadsheets, and presentations from your AI assistant.
Document editing, AI writing, saved documents, DOCX downloads, PDF, STT, TTS and watermarking
Real Word and Excel for agents: open your .docx/.xlsm, read, propose, apply, get it back intact.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading, creating, and appending content to Microsoft Word (.docx) files through natural language commands.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to directly read, edit, and manipulate Word documents, supporting image and table operations, paragraph editing, and search/replace.202MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to create, edit, and extract data from Microsoft Word documents programmatically, supporting document creation, content editing, table manipulation, parameter extraction, and template generation.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with rich editing capabilities.MIT