quickfile-mcp

面向 Quickfile REST API v2 的 MCP 服务器。多账户、密钥隔离。

功能

• 45 个工具 -- 每个对应一个 API operationId，由内嵌的 spec.json 生成。

• 多账户 -- 可配置多个 Quickfile 账户；每个工具都接受一个 account 参数。

• 两种认证模式 -- 静态 Personal Bearer Token 和 OAuth 2.0（自动刷新 + 轮换 refresh-token 持久化）。

• 密钥隔离 -- 令牌存放在 accounts.json（已 gitignore）中，绝不暴露给 AI 代理。工具模式仅暴露 account 选择器和端点参数。

Related MCP server: iikoServer MCP Server

设置

1. npm install

2. cp accounts.example.json accounts.json 并填写账户凭据。

3. npm run build

4. 配置你的 MCP 客户端（Claude Desktop 等）：

{
  "mcpServers": {
    "quickfile": {
      "command": "node",
      "args": ["path/to/quickfile-mcp/dist/index.js"],
      "cwd": "path/to/quickfile-mcp"
    }
  }
}

服务器从工作目录读取 accounts.json（或通过 QF_ACCOUNTS_FILE 环境变量指定自定义路径）。OAuth 令牌材料（accessToken、refreshToken、expiresAt）存放在由服务器管理的独立内部 tokens.json（或 QF_TOKENS_FILE）中——你无需手动编辑。

身份验证

静态令牌（自有账户）

在 QuickFile 中生成 Personal Bearer Token：账户设置 -> 第三方集成 -> API。在 accounts.json 中设置 "type": "static" 和 "token": "<your token>"。

OAuth（合作伙伴应用）

1. 在 QuickFile 中注册应用以获取 clientId / clientSecret。将这些信息放入 accounts.json，设置 "type": "oauth"。

2. 在带外完成 OAuth 授权 + 令牌交换流程（小型 CLI 或手动粘贴），以获取初始的 accessToken、refreshToken 和 expiresAt。

3. 一次性初始化 tokens.json：

   { "beta": { "accessToken": "...", "refreshToken": "...", "expiresAt": 0 } }

   此后，你无需再触碰 tokens.json——服务器会自动刷新即将过期的访问令牌，并将轮换后的 refresh token 持久化回该文件。

账户选择

每个工具都接受一个可选的 account 参数（已配置标签的枚举）。省略时使用 accounts.json 中的 defaultAccount。

API 参考

完整端点模式：src/spec.json（Swagger 2.0，45 个路径）。来源：Quickfile API 文档。