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许可证获得许可-有关详细信息，请参阅许可证文件。