使用说明
MCP PDF阅读器
一种模型上下文协议(MCP)服务器,提供读取和处理PDF文档的工具。使用Docling构建,用于文档转换和文本提取。
特性
- MCP服务器 使用PDF文档处理工具
- 文档文本提取:将PDF内容转换为干净的Markdown格式
- 文档发现:列出和访问可用的PDF文件
工具
服务器提供两个主要工具:
get_document_list:返回数据目录中所有可用PDF文件的列表get_document_text:以Markdown格式提取并返回指定PDF文件的全文内容
安装
确保你有 uv 安装.
克隆存储库:
git clone git@github.com:mlexpertio/mcp-pdf-reader.git
cd mcp-pdf-reader
安装Python:
uv python install 3.12.10
创建并激活虚拟环境:
uv venv
source .venv/bin/activate
安装依赖项:
uv sync
用法
添加PDF文档
将您的PDF文件放在 data/ 目录。服务器将自动检测并通过工具使其可用。
运行MCP服务器
启动MCP服务器:
python server.py
服务器使用stdio传输运行,可以与任何兼容MCP的客户端集成。
开发和测试
使用MCP检查器测试服务器:
mcp dev server.py
这将打开一个web界面,您可以在其中测试可用工具并检查它们的响应。
在VSCode/游标中使用
您可以在编辑器中使用MCP集成。 Tools & Integrations -> New MCP Server 并编辑 mcp.json 文件应包括以下内容:
{
"mcpServers": {
"pdf-reader": {
"command": "/opt/homebrew/bin/uv", // path to your uv binary
"args": ["run", "--directory", "PATH_TO_YOUR_PROJECT", "server.py"]
}
}
}
许可证
有关详细信息,请参阅LICENSE文件。
