本地MCP服务器

Aryn本地MCP服务器是一个用于处理PDF文件的工具,需要与文件系统MCP服务器配合使用,适用于开发者和技术用户。

  • by aryn-ai
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 aryn-ai/mcp-server

使用说明

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 错误:

  1. 验证UV安装跑 which uvx 在你的终端中找到正确的路径

  2. 使用uv的完整路径替换 "command": "uvx" (与)一起,带着,使用 "command": "<full path to uvx>"

如果你遇到文件权限错误,请确保路径已展开并通过,MCP客户端倾向于将它们视为字面目录名。针对具体问题:

  1. 输入目录确保文件系统连接器能够访问该目录,并且具有读取权限。

  2. 输出目录确保该目录具有写入访问权限。