arthub-mcp-server

# ArthHub MCP Server 一个用于ArthHub存储系统的MCP (Model Context Protocol) Server，提供文件上传等功能。 ## 功能特性 - 🚀 支持上传文件和目录到ArthHub资产库 - 📥 支持从ArthHub下载文件和目录 - 📁 支持创建、删除和查询目录/文件 - 🔍 支持查询目录下的子节点（递归/非递归） - 🔐 支持多种认证方式（邮箱密码、公共Token） - 📊 实时上传/下载进度追踪 - 🏷️ 支持为上传文件添加标签和描述 - 🔄 支持批处理工作流（探索-下载-处理-上传） ## 安装 ### 从源码安装 #### Windows ```powershell git clone <repository-url> cd arthub_mcp_server python -m pip install -e . ``` #### Linux / macOS ```bash git clone <repository-url> cd arthub_mcp_server pip install -e . ``` ### 使用pip安装 ```bash # Windows python -m pip install arthub_mcp_server # Linux / macOS pip install arthub_mcp_server ``` ## 配置 ### 环境变量 配置认证信息，选择以下方式之一： #### 方式一：使用邮箱和密码 ```bash export ARTHUB_EMAIL="your-email@example.com" export ARTHUB_PASSWORD="your-password" export ARTHUB_PUBLIC_KEY="your-public-key" ``` #### 方式二：使用公共Token ```bash export ARTHUB_PUBLIC_TOKEN="your-public-token" ``` #### 可选配置 ```bash # API配置名称，默认为 api_config_qq（外网访问） export ARTHUB_API_CONFIG="api_config_qq" ``` ### Cursor配置 在Cursor的MCP设置中添加以下配置（通常在 `~/.cursor/config.json` 或项目的 `.cursor/mcp.json`）： ```json { "mcpServers": { "arthub": { "command": "python", "args": ["-m", "arthub_mcp_server"], "env": { "ARTHUB_EMAIL": "your-email@example.com", "ARTHUB_PASSWORD": "your-password", "ARTHUB_PUBLIC_KEY": "your-public-key" } } } } ``` 或使用公共Token： ```json { "mcpServers": { "arthub": { "command": "python", "args": ["-m", "arthub_mcp_server"], "env": { "ARTHUB_PUBLIC_TOKEN": "your-public-token" } } } } ``` ## 使用方法 ### 1. 上传文件或目录 使用 `upload_file` 工具上传文件或整个目录到ArthHub： ```python # 上传单个文件 upload_file( asset_hub="trial", remote_dir_path="test/upload", local_file_path="/path/to/your/file.jpg", tags=["test", "demo"], description="测试上传文件", same_name_override…