使用说明
Aryn本地MCP服务器
安装
先决条件
- Python 3.12 或更高版本。请安装 在这里
- 紫外线 - 快速的Python包安装器和解析器
- 一个Aryn API密钥。您可以创建一个账户并免费获得一个密钥 这里
- 这款MCP服务器与文件系统MCP服务器配合使用效果最佳(请参阅下方的安装说明)
- 一个MCP服务器客户端,如Claude Desktop(推荐)或Claude Code
文件系统MCP
Aryn MCP服务器需要您提供想要处理的PDF文件的绝对路径作为输入,因此,当与能够自动管理您计算机上文件的MCP服务器配合使用时,效果最佳。以下是为Claude Desktop安装此类服务器的方法:
可以找到更多关于文件系统MCP服务器的文档 在这里.
Claude 桌面版一键安装(仅限 Claude 桌面版)
Claude Desktop 不需要手动安装此 MCP 服务器,而是支持一键轻松扩展:
下载扩展程序获取提供的(信息/内容) .dxt 从这个仓库获取文件,或为 macOS 下载它 这里 和Linux 在这里。
查找.dxt扩展名导航到文件下载所在的文件夹,然后双击进行安装。系统提示时,请按照安装步骤操作
重启Claude桌面版
现在你准备好了,出发吧!
如需更多详情,请参阅 Claude Desktop Extensions 文档。
手动安装
如果你正在手动安装这个MCP服务器,你需要进行安装 uv 首先,它提供了 uvx 命令。安装它 在这里。
安装后,您将可以访问两者 uv 并且 uvx 命令。该 uvx 命令是你用来运行这个MCP服务器的。
接下来,请在您的MCP客户端配置文件中添加以下配置
{
"mcpServers": {
"Aryn Local MCP Server": {
"command": "uvx",
"args": [
"aryn-mcp-server"
],
"env": {
"ARYN_API_KEY": "YOUR_ARYN_API_KEY",
"ARYN_MCP_OUTPUT_DIR": "<full path to directory where files will get saved (ie Users/username/Downloads)>"
}
}
}
}
对于特定客户端的配置实现,请参阅下文:
故障排除
如果你遇到 spawn uvx ENOENT 错误:
-
验证UV安装跑
which uvx在你的终端中找到正确的路径 -
使用uv的完整路径替换
"command": "uvx"(与)一起,带着,使用"command": "<full path to uvx>"
如果你遇到文件权限错误,请确保路径已展开并通过,MCP客户端倾向于将它们视为字面目录名。针对具体问题:
-
输入目录确保文件系统连接器能够访问该目录,并且具有读取权限。
-
输出目录确保该目录具有写入访问权限。