Submit
tnnevol

Auto-Save MCP 服务器

Community tnnevol
Updated

auto-save-mcp

Auto-Save MCP 服务器

一个符合 MCP (Model Context Protocol) 标准的服务器，用于集成 auto-save 服务，自动化处理网盘分享链接的转存任务。

功能特性

  • MCP 标准兼容：完全符合 Model Context Protocol 规范
  • 安全凭据管理：通过参数注入凭据，避免硬编码
  • 完整的 API 支持：支持 auto-save 的所有核心功能
  • 错误处理完善：包含完善的错误处理和状态反馈

支持的工具

add_task

添加一个新的自动保存任务到 auto-save 服务。

参数：

  • baseUrl (必填)：auto-save 服务的基础 URL (例如：http://localhost:5005)
  • token (必填)：认证令牌
  • taskname (必填)：任务名称
  • shareurl (必填)：夸克分享链接 (例如：https://pan.quark.cn/s/xxxxxx)
  • savepath (必填)：保存到网盘中的路径 (例如：/影视/测试)
  • pattern (可选)：文件匹配正则表达式
  • replace (可选)：重命名替换规则

get_config

获取 auto-save 服务的整体配置。

参数：

  • baseUrl (必填)：auto-save 服务的基础 URL
  • token (必填)：认证令牌

update_config

更新 auto-save 服务的整体配置。

参数：

  • baseUrl (必填)：auto-save 服务的基础 URL
  • token (必填)：认证令牌
  • config (必填)：要更新的配置对象

run_tasks

立即运行自动保存任务。

参数：

  • baseUrl (必填)：auto-save 服务的基础 URL
  • token (必填)：认证令牌
  • taskData (可选)：要运行的任务数据，如果不提供则运行所有任务

安装与部署

1. 克隆项目

git clone [email protected]:tnnevol/auto-save-mcp.git
cd auto-save-mcp

2. 安装依赖

npm install

3. 环境配置

创建 .env 文件配置默认值（可选）：

# .env.example 作为模板参考
QAS_BASE_URL=http://your-auto-save-service:port
QAS_TOKEN=your-actual-token-here

启动服务器

本地启动

npm start

服务器将启动在 http://localhost:8080。

OpenClaw MCP 配置

要将此 MCP 服务器集成到 OpenClaw 中，需要在 OpenClaw 配置文件中添加以下配置：

{
  "mcpServers": {
    "auto-save": {
      "url": "http://localhost:8080",
      "enabled": true,
      "name": "Auto-Save Service",
      "description": "Automate Quark Cloud Drive file saving from share links"
    }
  }
}

配置完成后重启 OpenClaw，MCP 客户端将能够发现并使用本服务器提供的工具。

使用示例

添加任务

在支持 MCP 的客户端中，调用 add_task 工具并传递相应的参数。

获取配置

调用 get_config 工具以获取当前服务配置。

更新配置

调用 update_config 工具以更新服务配置。

运行任务

调用 run_tasks 工具以立即执行保存任务。

安全说明

  • 所有认证凭据（baseUrl 和 token）通过参数动态注入
  • 不会在代码中硬编码任何敏感信息
  • 通过环境变量也可以预设凭据，但不推荐在生产环境中使用

开发

如需定制开发：

  1. 克隆仓库
  2. 安装依赖：npm install
  3. 启动开发模式：npm run dev（如果配置了的话）
  4. 修改 index.js 中的工具定义
  5. 测试更改

故障排除

如果遇到连接问题，请检查：

  1. 服务器是否正在运行（默认端口 8080）
  2. 网络连接是否正常
  3. 认证凭据是否正确
  4. 防火墙设置是否允许相应端口通信

许可证

MIT License

MCP Server · Populars

MCP Server · New