返回 MCP 目录
public公开dns本地运行

Document Reader

一个基础的MCP服务器,用于与PDF和EPUB文档交互。

article

README

🚀 mcp-document-reader

mcp-document-reader是一个基础的MCP服务器,用于与PDF和EPUB文档进行交互。我使用该工具搭配Windsurf IDE by Codeium,不过该IDE仅支持MCP工具,不支持资源。

🚀 快速开始

安装

先决条件

# 克隆仓库
git clone https://github.com/jbchouinard/mcp-document-reader.git
cd mcp-document-reader
poetry install

配置MCP服务器

使用poetry运行

{
  "mcpServers": {
    "documents": {
      "command": "poetry",
      "args": ["-C", "path/to/mcp-document-reader", "run", "mcp-document-reader"]
    }
  }
}

构建并使用pip安装,然后直接运行脚本

poetry build
pipx install dist/*.whl
which mcp-document-reader

然后使用以下配置(输出路径替换为实际路径):

{
  "mcpServers": {
    "documents": {
      "command": "/path/to/mcp-document-reader",
      "args": []
    }
  }
}

📦 安装指南

安装依赖

# 安装依赖项
poetry install

💻 使用示例

测试

poetry run pytest

代码检查

poetry run ruff check --fix .
poetry run ruff format .

📄 许可证

本项目采用MIT许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端