quickfile-mcp

Quickfile REST API v2 用のMCPサーバー。マルチアカウント対応、秘密情報を隔離。

機能

• 45ツール -- 埋め込まれた spec.json から生成された、API operationId ごとに1つ。

• マルチアカウント -- 複数の Quickfile アカウントを設定可能。各ツールは account パラメータを受け取ります。

• 両方の認証モード -- 静的パーソナルベアラートークンと OAuth 2.0（自動更新 + ローテーションするリフレッシュトークンの永続化）。

• 秘密情報の隔離 -- トークンは 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 でパーソナルベアラートークンを生成します：アカウント設定 -> サードパーティ連携 -> API。accounts.json で "type": "static" と "token": "<your token>" を設定します。

OAuth（パートナーアプリ）

1. QuickFile でアプリを登録し clientId / clientSecret を取得します。これらを "type": "oauth" とともに accounts.json に設定します。

2. 帯域外で OAuth 認証 + トークン交換フローを完了し（小さなCLIまたは手動ペースト）、最初の accessToken、refreshToken、expiresAt を取得します。

3. tokens.json を一度だけシードします：

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

この後、tokens.json に触れる必要はありません。サーバーが期限切れのアクセストークンを自動更新し、ローテーションされたリフレッシュトークンをそこに永続化します。

アカウント選択

すべてのツールはオプションの account パラメータ（設定済みラベルの列挙型）を受け取ります。省略すると accounts.json の defaultAccount が使用されます。

APIリファレンス

完全なエンドポイントスキーマ：src/spec.json（Swagger 2.0、45パス）。出典：Quickfile API docs。