AI导哈

Word文档智能处理工具

集成Google Gemini AI和Model Context Protocol (MCP)的Word文档智能处理工具，支持自动生成、分析和修改Word文档。

  • by ldsilvadev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ldsilvadev/mcp-word-caller

使用说明

MCP双子字

Google Gemini AI 与模型上下文协议 （MCP） 的集成，用于智能处理 Word 文档 （.docx）。

📋 关于项目

该项目允许Google Gemini AI通过模型上下文协议（MCP）处理Word文档，从而实现：

  • ✍️ 自动从模板创建Word文档
  • 📝 分析和修改现有文件
  • 🤖 结构化内容生成（章节、表格、格式）
  • 🔄 通过 Gemini 函数调用与 Python 工具集成

🚀 技术

  • TypeScript 主要语言
  • 谷歌双子座AI （Gemini-2.5-Pro）-人工智能模型
  • 模型上下文协议（MCP） 与 Python 工具交流
  • docxtemplator 处理Word模板
  • 猛犸 阅读Word文档
  • 萨德 - 方案验证

📦 安装

# Instalar dependências
npm install

# Configurar variáveis de ambiente
cp .env.example .env

在文件中配置您的 Google Gemini API 密钥 .env:

GOOGLE_API_KEY=sua_chave_aqui

⚙️ 路径设置

重要提示： 该项目使用模板和输出文件的绝对路径。您必须在两个位置配置这些路径：

1.系统提示(src/config/systemPrompts.ts)

在档案中 systemPrompts.ts找到该部分 ### PATH HANDLING 并根据其结构更新路径示例：

### PATH HANDLING
- **Template Path**: O backend fornece o caminho absoluto para o template
  Exemplo: "C:\\Users\\seu-usuario\\Documents\\projeto\\templates\\template.docx"

- **Output Path**: O backend fornece o caminho absoluto para salvar documentos
  Exemplo: "C:\\Users\\seu-usuario\\Documents\\projeto\\output\\"

2. 用户提示（src/index.ts)

请求时，始终提供完整的绝对路径：

// ✅ CORRETO - Caminho absoluto
const promptDoUsuario = `
  Analise o documento em C:\\Users\\seu-usuario\\Documents\\projeto\\output\\documento.docx
  e modifique o título "Objetivo" para "Objetivo da Política".
`;

// ❌ ERRADO - Caminho relativo
const promptDoUsuario = `
  Analise o documento em ./output/documento.docx
`;

推荐的文件夹结构

seu-projeto/
├── templates/
│   └── template.docx          # Template base (caminho absoluto necessário)
├── output/                    # Documentos gerados (caminho absoluto necessário)
└── src/
    └── ...

智利 使用 path.resolve() 或 __dirname 必要时动态构建绝对路径。

🎯 如何使用

运行工程

npx tsx src/index.ts

使用范例

1. 从模板创建文档：

const promptDoUsuario = `
  Crie uma política de Home Office.
  
  Preencha com estas informações:
  - Código: FIERGS-HO-321
  - Assunto: Política de Home Office
  - Departamento: RH
  - Revisão: 1
  - Data de publicação: 25/11/2024
  - Data de vigência: 25/11/2026
  
  Diretrizes:
  1. Crie no mínimo 8 seções textuais bem elaboradas.
  2. Crie uma tabela "tabela_dinamica" com colunas: Cargo, Limite Horas, Home Office.
`;

2.编辑当前文档：

const promptDoUsuario = `
  Analise o documento em C:\\caminho\\documento.docx
  e modifique o título "Objetivo" para "Objetivo da Política".
`;

🏗️ 项目结构

mcp-gemini-word/
├── src/
│   ├── api/
│   │   └── chatApi.ts          # Integração com Gemini AI
│   ├── config/
│   │   └── systemPrompts.ts    # Instruções do sistema
│   ├── registry/
│   │   └── toolRegistry.ts     # Registro de ferramentas MCP
│   ├── services/
│   │   └── mcpService.ts       # Comunicação com MCP Python
│   └── index.ts                # Ponto de entrada
├── templates/
│   └── template.docx           # Template base para documentos
├── output/                     # Documentos gerados
└── package.json

🔧 操作

  1. 用户发送提示 → 自然语言申请
  2. 双子座analisa 确定使用哪些工具
  3. 函数调用 → Gemini 调用 MCP Python 工具
  4. MCP 运行 →操纵Word文档
  5. 最终答案 Gemini 将结果返回给用户

🛠️ 可用工具

该项目通过MCP动态连接到Python工具，包括：

  • 创建Word文档
  • 填充模板
  • 内容分析
  • 结构修改
  • 表格生成和格式

📝 要求

  • Node.js 18+
  • TypeScript 5+
  • 配置的Python MCP服务器
  • Google Gemini API 密钥

🤝 贡献

欢迎捐款！您可以随时打开 issues 或 pull requests。

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP