内容
# PDF 阅读器 MCP 服务器
一个用于读取 PDF 文件并提取文本内容的 MCP 服务器。
## 安装
```bash
cd /path/to/pdfreaderMCP
pip install -r requirements.txt
```
## MCP 配置
将以下内容添加到您的 `~/.cursor/mcp.json` 或 `/root/.cursor/mcp.json` 中:
```json
{
"mcpServers": {
"pdf-reader": {
"command": "python3",
"args": [
"/absolute/path/to/server.py"
]
}
}
}
```
**注意:** 请将 `/absolute/path/to/server.py` 替换为您的 `server.py` 文件的实际路径。
## 可用工具
### 1. read_pdf
读取 PDF 文件并提取文本内容。
**参数:**
- `file_path` (必填):要读取的 PDF 文件的路径
- `page_range` (可选):要读取的页面范围
- `"all"`:所有页面(默认值)
- `"1-5"`:第 1 页至第 5 页
- `"1,3,5"`:仅第 1 页、第 3 页和第 5 页
- `"1-3,7,10-12"`:混合范围
**示例:**
```python
# 读取所有页面
read_pdf(file_path="/path/to/document.pdf")
# 读取特定页面
read_pdf(file_path="/path/to/document.pdf", page_range="1-10")
```
### 2. get_pdf_info
获取 PDF 文件的元数据信息。
**参数:**
- `file_path` (必填):要获取信息的 PDF 文件的路径
**示例:**
```python
get_pdf_info(file_path="/path/to/document.pdf")
```
## 功能
- ✅ PDF 文本提取
- ✅ 页面范围指定
- ✅ PDF 元数据检索(标题、作者、日期等)
- ✅ Unicode 支持(韩文、中文、日文等)
## 依赖项
- `mcp>=1.0.0`:Model Context Protocol 服务器库
- `pymupdf>=1.24.0`:PDF 处理库(PyMuPDF)
## 故障排除
### ImportError: mcp package not found
```bash
pip install mcp
```
### ImportError: fitz (PyMuPDF) not found
```bash
pip install pymupdf
```
## 重启 Cursor
配置更改后,请重启 Cursor 以激活新的 MCP 服务器。
## 许可证
MIT 许可证 - 免费使用、修改和分发。
请参阅 [LICENSE](LICENSE) 文件了解详情。