Aryn Local MCP Server

安装

预备条件

• Python 3.12 或更高版本。在这里安装。
• uv - 快速的Python包安装器和解析器
• Aryn API密钥。你可以在这里免费创建账户并获取密钥。
• 这个MCP服务器与文件系统MCP服务器结合使用效果最佳（参见下面的安装说明）。
• 类似Claude Desktop的MCP服务器客户端（推荐）或Claude Code。

文件系统MCP

Aryn MCP服务器需要绝对文件路径作为输入，因此它与能够自动管理计算机上文件的MCP服务器配合使用效果最佳。这里是为Claude Desktop安装一个的方法：

更多关于文件系统MCP服务器的文档可以在这里找到。

Claude Desktop一键安装（仅限Claude Desktop）

无需手动安装此MCP服务器，Claude Desktop允许轻松的一键扩展：

下载扩展：从这个仓库中获取提供的.dxt文件，或者为macOS 在这里下载，为Linux 在这里下载。

找到.dxt扩展：导航到文件下载的文件夹，双击以进行安装。按照提示完成安装步骤。

重启Claude Desktop

现在你可以开始了！

更多详情，请参考Claude Desktop扩展文档。

手动安装

如果你要手动安装此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": "<完整路径到文件保存目录（例如Users/username/Downloads）>"
      }
    }
  }
}

针对特定客户端的配置实现如下：

• Claude
• Cursor

故障排除

如果你遇到spawn uvx ENOENT错误：

1. 验证uv安装：在终端中运行which uvx以找到正确的路径。

2. 使用uv的完整路径：将"command": "uvx"替换为"command": "<uvx的完整路径>"。

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

1. 输入目录：确保文件系统连接器有权访问该目录，并且它是可读的。

2. 输出目录：确保该目录是可写的。