Document Reader MCP Git

产品定位

文档阅读器 MCP 服务器专注于提供多格式文档的读取和媒体内容分析功能，适用于需要处理和分析文档内容的场景。

核心功能

• 多格式文档读取: 支持 Word (.docx)、PDF、文本文件、RTF 等格式
• 图片提取与分析: 自动提取文档中的图片并进行结构分析
• 图表内容理解: 基于 OpenCV 分析流程图、架构图等技术图表
• 媒体信息提取: 提取文档中的图片和链接信息
• 链接验证: 自动检查文档中链接的有效性
• 页面范围选择: PDF 文档支持指定页面范围读取

适用场景

• 增强文档阅读
• 开发时文档分析
• 文档内容分析和审计
• 媒体资源清单生成
• 链接有效性批量检查
• 文档迁移前的资源盘点

使用教程

1. 安装依赖

# 方式1：使用安装脚本（推荐）
python install_deps.py

# 方式2：手动安装
pip install -r requirements.txt

2. 启动服务器

python server.py

3. 配置 Kiro IDE

在 Kiro IDE 中创建或编辑 .kiro/settings/mcp.json 文件：

方式1：简化配置（推荐）

{
  "mcpServers": {
    "document-reader": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "D:\\your-path\\document-reader-mcp",
      "env": {
        "PYTHONIOENCODING": "utf-8"
      },
      "disabled": false,
      "autoApprove": [
        "list_supported_formats",
        "get_document_info",
        "read_document",
        "read_document_with_media"
      ]
    }
  }
}

方式2：完整路径配置

{
  "mcpServers": {
    "document-reader": {
      "command": "python",
      "args": ["D:\\devolp\\code1\\document-reader-mcp-master\\document-reader-mcp\\server.py"],
      "cwd": "D:\\devolp\\code1\\document-reader-mcp-master\\document-reader-mcp",
      "env": {
        "PYTHONPATH": "D:\\devolp\\code1\\document-reader-mcp-master\\document-reader-mcp",
        "PYTHONIOENCODING": "utf-8"
      },
      "disabled": false,
      "autoApprove": [
        "list_supported_formats",
        "get_document_info",
        "read_document",
        "read_document_with_media"
      ]
    }
  }
}

4. 测试功能

# 测试图表分析
python simple_diagram_reader.py

# 测试核心功能
python test_core_features.py