MCP PDF 服务器
MCP PDF 服务器是一个基于模型上下文协议 (MCP) 的服务器，可以有效地管理 PDF 文件。
这个项目是为了方便我这个嵌入式开发者，直接在Cursor等AI编程工具中阅读、汇总PDF datasheet文档，或者进行问答，让开发工作更加便捷而创建的。换句话说，主要目的是支持AI快速理解PDF数据表的内容并立即提供必要的信息。
该项目由两个主要部分组成：
manager_server ：基于 FastAPI 的网页，为用户提供通过 Web UI 上传或下载 PDF 文件以及查看和管理文件列表的功能。它还提供了用于与外部系统集成的 RESTful API。
mcp_server ：根据 manager_server 管理的 PDF 文件提供文件名搜索和文本提取功能。提取的文本可以通过 MCP 协议链接到外部系统（例如 Cursor 等）。
主要特点：
提取 PDF 文本（支持本地文件和 URL）
根据文件名搜索 PDF
查看和管理 PDF 列表
支持PDF文件网页上传/下载
提供 RESTful API 和 Web 服务
通过 MCP 协议连接到外部系统（Curator、Cursor 等）
它可以通过RESTful API和Web UI轻松地与外部系统集成，并可以在Docker和本地环境中轻松部署和运行。适用于数据表、论文、合同等各种PDF文档的自动化管理和检索。
主要特点
从本地 PDF 文件和可通过 URL 访问的 PDF 中提取文本
提供
/app/datasheets下的 PDF 文件列表提供按文件名搜索PDF的功能
基于 PyPDF2 的可靠文本提取和异常处理
提供基于FastMCP的标准化MCP工具
Related MCP server: File MCP Server
使用 Docker 运行
构建镜像
docker build -t mcp-pdf-server:1.0.0 .运行容器
docker run -d \ -v /호스트/경로/데이터:/app/datasheets \ -p 5050:5050 \ -p 5080:5080 \ --name mcp-pdf-server \ mcp-pdf-server:1.0.0如果您将 PDF 文件放在
/호스트/경로/데이터则可以从容器内的/app/datasheets访问它。使用端口 5050 和 5080。
使用 docker-compose 时
# docker-compose.yml의 /path/to/your/datasheets를 실제 PDF 폴더 경로로 수정하세요. docker-compose up -d --build
直接在本地运行（Python）
安装依赖项
pip install -r requirements.txt运行服务器
python mcp_server/mcp_pdf_server.py # 또는 uvicorn manager_server.main:app --host 0.0.0.0 --port 5080
MCP 工具（API）说明
读取本地PDF
通过输入本地 PDF 文件路径来提取文本。阅读网址
输入 PDF 文件的 URL 并从中提取文本。服务器 PDF 列表
返回/app/datasheets下所有 PDF 文件的列表。服务器 PDF 搜索
输入文件名，在服务器上搜索 PDF 文件，然后从该 PDF 文件中提取文本。
路线指引
PDF 数据必须位于
/app/datasheets路径（Docker 容器内）。使用 Docker 时，将主机的 PDF 文件夹挂载到
/app/datasheets。源代码位于
/app/mcp_server（容器内）。
执照
Apache 许可证 2.0
作者：Dev91