Office MCP Server

Office MCP 服务

Office MCP 服务 是一个非官方的 Model Context Protocol (MCP) Server，基于 Java 构建，旨在管理和处理 AI Agent 对 Word、Excel 等文件的请求。

框架

本项目使用 Quarkus 构建。Quarkus 是一个面向 Kubernetes 的 Java 框架，专为构建轻量、高性能的微服务而设计。Quarkus 启动速度快、内存占用低，因此非常适合云原生应用。

支持的方法

该服务支持以下 MCP 工具和资源：

Excel 功能

• 工具：获取文件名：获取 Excel 文件的文件名。
  • 参数：filename - Excel 文件的名称。
• 工具：创建 Excel 工作簿：创建新的 Excel 工作簿。
  • 参数：filepath - 创建新 Excel 工作簿的路径。
• 工具：创建 Excel 工作表：在 Excel 工作簿中创建新的工作表。
  • 参数：
    • filepath - Excel 工作簿的路径。
    • sheetName - 新工作表的名称。
• 工具：添加 Excel 行：在 Excel 工作表中添加一行。
  • 参数：
    • filepath - Excel 工作簿的路径。
    • sheetName - 工作表的名称。
    • rowData - 新行的数据。
• 工具：读取 Excel 单元格：读取 Excel 工作表中的单元格。
  • 参数：
    • filepath - Excel 工作簿的路径。
    • sheetName - 工作表的名称。
    • rowNum - 行号（从 0 开始）。
    • colNum - 列号（从 0 开始）。
• 工具：关闭 Excel 工作簿：关闭 Excel 工作簿。
  • 参数：filepath - Excel 工作簿的路径。
• 工具：获取 Excel 工作表数量：获取 Excel 工作簿中的工作表数量。
  • 参数：filepath - Excel 工作簿的路径。
• 工具：获取 Excel 行数：获取工作表中的行数。
  • 参数：
    • filepath - Excel 工作簿的路径。
    • sheetName - 工作表的名称。
• 工具：获取 Excel 列数：获取工作表中的列数。
  • 参数：
    • filepath - Excel 工作簿的路径。
    • sheetName - 工作表的名称。

Word 功能

• 工具：创建 Word 文档：创建新的 Word 文档。
  • 参数：filepath - 创建新 Word 文档的路径。
• 工具：向 Word 文档添加文本：向 Word 文档添加文本。
  • 参数：
    • filepath - Word 文档的路径。
    • text - 要添加的文本。

PowerPoint 功能

• 工具：创建 PowerPoint 演示文稿：创建新的 PowerPoint 演示文稿。
  • 参数：filepath - 创建新 PowerPoint 演示文稿的路径。
• 工具：向 PowerPoint 添加幻灯片：向 PowerPoint 演示文稿添加新幻灯片。
  • 参数：filepath - PowerPoint 演示文稿的路径。
• 工具：向 PowerPoint 幻灯片添加文本：向 PowerPoint 演示文稿中的指定幻灯片添加文本。
  • 参数：
    • filepath - PowerPoint 演示文稿的路径。
    • slideIndex - 幻灯片索引（从 0 开始）。
    • text - 要添加的文本。
• 工具：读取 PowerPoint 幻灯片标题：读取 PowerPoint 演示文稿中所有幻灯片的标题。
  • 参数：filepath - PowerPoint 演示文稿的路径。
• 工具：获取 PowerPoint 幻灯片数量：获取 PowerPoint 演示文稿中的幻灯片数量。
  • 参数：filepath - PowerPoint 演示文稿的路径。

如何调试和独立运行

要运行 Office MCP 服务，请按以下步骤操作：

1. 构建应用程序： 确保已安装 Maven。运行以下命令以构建项目：

   $ ./mvnw clean package
   

2. 运行应用程序： 构建完成后，执行以下命令以启动服务：

   $ java -jar target/office-mcp-server-0.0.1-SNAPSHOT-runner.jar
   

3. 访问应用程序： 服务将在默认端口 8080 上启动。你可以通过以下地址访问 API：

   http://localhost:8080
   

4. 在开发模式下运行： 如需进行开发，可以使用 Quarkus 的开发模式：

   $ ./mvnw quarkus:dev
   

配置

可以使用位于 src/main/resources 目录中的 application.properties 文件配置应用程序。主要配置选项包括：

• quarkus.mcp.server.sse.root-path：设置 SSE 根路径。

测试

要运行测试，请使用以下命令：

$ ./mvnw test

安装 MCP 服务

使用 VS Code 配置 MCP 服务

以下是在 VS Code 中进行配置的步骤：

• 安装 GitHub Copilot
• 使用命令面板安装此 MCP 服务：MCP: Add Server...
• 点击聊天窗口底部的箭头，将 GitHub Copilot 设置为 Agent 模式
• 在聊天窗口顶部，你应该能看到已配置为工具的 office-mcp-server 服务

使用 Claude Desktop 配置 MCP 服务

Claude Desktop 让配置 MCP 服务并与其聊天变得简单。如果需要更高级的用法，我们建议使用 VS Code（见下一节）。

你需要将服务添加到 claude_desktop_config.json 文件中。请注意，你需要指定下载的 office-mcp-server-0.0.1-SNAPSHOT-runner.jar 文件所在的位置。

{
    "mcpServers": {
        "office-mcp-server": {
            "command": "java",
            "args": [
                "-jar",
              "~/Downloads/office-mcp-server-0.0.1-SNAPSHOT-runner.jar"
            ]
        }
    }
}

许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。

支持

本项目按原样提供，不提供任何保证。如果遇到问题或有疑问，请在 GitHub 仓库中提交 issue。