Office文件处理服务器

Office MCP Server是一个基于Java的服务器,用于管理和处理AI代理对Word、Excel等Office文件的请求。

  • by lescoggi
  • Java
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 lescoggi/office-mcp-server

使用说明

Office MCP服务器

这 Office MCP服务器 是非官方的 模型上下文协议(MCP)服务器 基于Java服务器,旨在管理和处理来自AI代理的Word、Excel等文件的请求。

框架

该项目是使用 夸库斯,一个为构建轻量级、高性能微服务而量身定制的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文档。
    • 论证: 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
    

配置

可以使用配置应用程序 application.properties 文件位于 src/main/resources 目录。关键配置选项包括:

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

测试

要运行测试,请使用以下命令:

$ ./mvnw test

安装MCP服务器

使用VS代码配置MCP服务器

以下是在VS Code中配置的步骤:

  • 安装GitHub副本
  • 使用命令面板安装此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 文件以获取详细信息。

支持

本项目按原样提供,不提供任何保修。如果您遇到问题或有疑问,请在GitHub存储库上打开问题。