MCP Document Parse Tool

项目介绍

这是一个MCP（Model Communication Protocol）工具，用于帮助解析各种格式的文档（PDF、Word、Excel、PPT等）获取其内容。该工具提供了简单易用的接口，使您能够在各种应用中集成文档解析功能。

支持的文件格式

• PDF (.pdf) - 支持可编辑 PDF 和扫描件
• Word (.doc, .docx)
• Excel (.xls, .xlsx)
• PowerPoint (.ppt, .pptx)

安装方法

使用 uv 安装并启动发布版

uv tool install mcp-document-parse

环境变量

• NIUTRANS_API_KEY（必填）：小牛翻译开放平台提供文档API的 API Key,可免费使用, 请登录后获取:https://niutrans.com/cloud/api/list
• NIUTRANS_DOCUMENT_APPID（必填）：小牛翻译开放平台提供文档API的 APPID,可免费使用, 请登录后获取:https://niutrans.com/cloud/api/list

计费说明

本工具使用小牛翻译开放平台的文档解析 API，计费规则如下：

文件类型	计费标准
PDF / Word / PPT	1 页 = 2 积分
Excel	2000 字符 = 2 积分

💡 免费额度：平台每天赠送 100 积分，供大家免费使用！

环境要求

• Python >= 3.9
• 依赖项已在 pyproject.toml 中定义

MCP 客户端配置示例

若通过 uv tool install 安装，可在 mcp.json 中配置：

{
  "mcpServers": {
    "document_parse": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "mcp-document-parse"
      ],
      "env": {
        "NIUTRANS_API_KEY": "${env.NIUTRANS_API_KEY}",
        "NIUTRANS_DOCUMENT_APPID": "${env.NIUTRANS_DOCUMENT_APPID}"
      }
    }
  }
}

启动支持MCP的应用后，执行 ListTools 即可看到 parse_document_by_path 工具，同时支持 ListResources 读取 document://supported-types。

工具说明

parse_document_by_path

将指定路径的文件转换为Markdown格式。

参数：

• file_path (str): 文件的绝对路径，支持pdf、doc、docx、xls、xlsx、ppt、pptx格式

返回：

• 成功: {"status": "success", "text_content": "文件内容", "filename": 文件名}
• 失败: {"status": "error", "error": "错误信息"}

document://supported-types

获取支持的文件类型信息。

返回：

• 包含支持的文件类型列表及其描述的JSON对象

许可证

MIT License

联系方式

如有问题或建议，请联系 tianfengning@niutrans.com