关键词

文档编辑Word操作Excel操作PDF操作文件转换

项目简介

Claude Document MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 Claude 桌面应用提供文档操作能力。它允许 Claude 通过标准化的 MCP 协议，调用服务器提供的工具来创建、编辑和转换 Microsoft Word、Excel 和 PDF 文档。

主要功能点

  • Word 文档操作
    • 创建新的 Word 文档
    • 编辑现有 Word 文档（添加/编辑/删除段落和标题）
    • 将文本文件 (.txt) 转换为 Word 文档
  • Excel 文件操作
    • 创建新的 Excel 电子表格
    • 编辑现有 Excel 文件（更新单元格、范围，添加/删除行、列、工作表）
    • 将 CSV 文件转换为 Excel 文件
  • PDF 文件操作
    • 创建新的 PDF 文件
    • 将 Word 文档转换为 PDF 文件

安装步骤

  1. 环境准备：确保已安装 Python 3.10 或更高版本。推荐使用 'uv' 包管理器（如果尚未安装，请先安装 'uv'）。
  2. 下载仓库：将仓库 'document-edit-mcp' 克隆到本地。
  3. 自动安装 (推荐)：
    • 打开终端，进入仓库根目录 'document-edit-mcp'。
    • 运行 './setup.sh' 脚本。该脚本会自动创建虚拟环境、安装依赖、配置 Claude Desktop 并创建必要的目录。
  4. 手动安装 (备选)：
    • 创建虚拟环境：在仓库根目录运行 'python -m venv .venv'。
    • 激活虚拟环境：运行 'source .venv/bin/activate' (macOS/Linux) 或 '.venv\Scripts\activate' (Windows)。
    • 安装依赖：运行 'pip install -e .'。

服务器配置

MCP 服务器需要配置到 MCP 客户端（例如 Claude 桌面应用）中才能使用。配置信息通常是 JSON 格式，用于告知客户端如何启动和连接服务器。

以下是 'claude_desktop_config.json' 文件的配置示例，请根据实际情况配置到 Claude 桌面应用中 (通常 Claude 桌面应用有配置入口，将以下 JSON 内容填入即可，请勿直接复制到文件路径):

{
  "servers": [
    {
      "server_name": "Document Operations",  // 服务器名称，需要与server.py中FastMCP实例化的名称一致
      "command": "python",                 // 启动服务器的命令，这里使用 python
      "args": [                           // 启动服务器的参数
        "-m",
        "claude_document_mcp.server"      // 指定运行 claude_document_mcp.server 模块
      ]
    }
  ]
}

配置说明:

  • 'server_name': 服务器的显示名称，应与 'claude_document_mcp/server.py' 中 'FastMCP' 实例化时传入的 'name' 参数保持一致，本例中为 '"Document Operations"'。
  • 'command': 启动服务器的命令，通常为 'python' 或 'python3'，确保 Claude 桌面应用可以找到 Python 解释器。
  • 'args': 启动参数，指定 Python 运行的模块为 'claude_document_mcp.server'，即服务器的入口点。

Claude Desktop 配置文件路径 (仅供参考，请勿直接修改文件):

  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

注意: 'setup.sh' 脚本会自动将 'claude_desktop_config.json' 文件复制到上述 Claude Desktop 配置目录中，推荐使用自动安装方式。手动安装则需要您自行复制配置文件。

基本使用方法

  1. 启动服务器：

    • 方法一 (推荐)：在仓库根目录运行 './run.sh' 脚本。
    • 方法二：手动激活虚拟环境后，在仓库根目录运行 'uv run -m claude_document_mcp.server'。

  2. 配置 Claude 桌面应用：按照上述 "服务器配置" 部分，将配置信息添加到 Claude 桌面应用中。

  3. 在 Claude 中使用：配置完成后，Claude 桌面应用即可通过 MCP 协议与该服务器通信，利用服务器提供的文档操作工具。具体使用方式请参考 Claude 桌面应用的相关文档，通常在 Claude 的界面中，您可以通过某种方式（例如自然语言指令）指示 Claude 进行文档操作，Claude 会自动调用配置的 MCP 服务器来完成任务。

日志查看：服务器运行日志会记录在控制台以及仓库根目录下 'logs/document_mcp.log' 文件中，用于问题排查。

信息

分类

桌面与硬件

访问项目