tasqr-mcp (Node)

Tasqr MCP サーバー — AI エージェント向けのタスク状態管理。

ローカルの stdio プロセスとして動作し、~/.config/tasqr/credentials から API キーを読み取り、ツール呼び出しを Tasqr Lambda MCP サーバーにプロキシします。MCP クライアント設定には秘密情報は一切含まれません。API キーは資格情報ファイルにのみ保存されます（Mac/Linux では 0600 で書き込まれ、Windows ではプロファイルディレクトリの ACL に依存します）。

インストール

Node 22 以降が必要です。

npx tasqr-mcp        # run once without installing
# or
npm install -g tasqr-mcp

Related MCP server: pith

MCP クライアント設定

{
  "mcpServers": {
    "tasqr": {
      "command": "npx",
      "args": ["tasqr-mcp"]
    }
  }
}

資格情報

初回実行 — セットアップ不要。 ターミナルでプロキシを一度実行してください:

npx tasqr-mcp

ディスクに API キーがない場合、GitHub のデバイスフローによるサインアップが開始されます。ブラウザで GitHub が開き、デバイスコードがクリップボードにコピーされて貼り付けを求められ、（アカウントに複数のワークスペースがある場合は）どれを使うか尋ねられます。その後、資格情報ファイルが自動的に書き込まれます。手動で作成したい場合にのみ、以下の手順が必要です。

MCP クライアントが秘密情報を見ることはありません。npx tasqr-mcp を起動するだけで、キーは以下から読み取られます:

~/.config/tasqr/credentials   (Mac/Linux)
%APPDATA%\tasqr\credentials   (Windows)

[default]
api_key = tasqr_abc123...

Mac/Linux ではファイルは 0600（所有者のみ読み書き可能）で書き込まれます。Windows ではプロファイルディレクトリの ACL を継承します。Web からキーを取得したい場合は tasqr.ai でサインアップしてください。

サインアップは対話式のため、stdin が TTY の場合にのみ実行されます。ヘッドレスでプロキシを起動した MCP クライアントでキーがない場合は、終了してターミナルで npx tasqr-mcp を実行するよう指示されます。

ロギング

ロギングはデフォルトでオフ — 有効にしない限り、ディスクには何も書き込まれません。有効にすると、プロキシは追記専用の JSON ライン形式のイベントログを保持し、メタデータのみを記録します。ツール名とフィールド名のみで、タスクの内容やキー素材は一切記録されません。

資格情報ファイルで有効にします:

[default]
api_key   = tasqr_abc123...
log_level = info                        # off (default) | info | debug
log_path  = ~/.config/tasqr/tasqr-mcp.log

ローテーションやサイズ上限はないため、debug はトラブルシューティング用であり、常時有効にするものではありません。

環境変数

環境変数は資格情報ファイルより優先され、資格情報ファイルはデフォルト値より優先されます。

クライアント側暗号化 (BYOK)

タスクのフィールド（タイトル、説明、メタデータ、出力、メモ）を Tasqr サーバーに届く前にローカルで暗号化します。自分で管理する AWS KMS キーが必要です。

AWS SDK はすでに含まれています。 @aws-sdk/client-kms と @aws-sdk/credential-providers はオプションの依存関係として同梱されており、npm はデフォルトでインストールします。通常の npx tasqr-mcp や npm install -g tasqr-mcp には BYOK に必要なものがすべて含まれています。--omit=optional を付けてインストールした場合のみ不足します。その場合は、そのフラグなしで再インストールすれば BYOK を使用できます。

資格情報ファイルに追加:

[default]
api_key      = tasqr_abc123...
kms_key_id   = arn:aws:kms:us-east-1:123456789012:key/your-key-id
aws_profile  = default

Tasqr オーガニゼーションがクライアント側 BYOK に登録されている必要があります。 起動時にプロキシはサーバーにオーガニゼーションがどのモードを使用しているかを問い合わせます。サーバー管理モードの場合、暗号化せずに起動を拒否します。サーバーが暗号文を二重に暗号化し、ダッシュボード、REST API、他のエージェントからデータが読めなくなり、KMS キーを失うと復元不能になるためです。エラーメッセージはどのプロファイルを修正すべきかを示します。

登録後、プロキシはデータ暗号化キー (DEK) を取得または生成し、KMS でラップして、ラップされたキーを Tasqr API に保存します。以降の実行では、キャッシュされた DEK を 1 回の KMS 呼び出しでアンラップします。すべての AES-256-GCM 暗号化はメモリ内で行われ、平文の DEK がプロセス外に出ることはありません。

各暗号文はさらにコンテキストにバインドされます。GCM の関連データにより、各暗号化値はオーガニゼーション、そのタスク、書き込まれたフィールドに結び付けられます。別のスロット（別のフィールド、タスク、オーガニゼーション）に移動されたブロブは、誤った場所で復号される代わりに、復号が完全に失敗します。これを可能にするため、プロキシは新しいタスクの ID を自ら生成し、作成呼び出しとともに送信します。

完全なセットアップ手順については、クライアント側暗号化ガイド を参照してください。

ローカル開発

npm install
npm test
node bin/tasqr-mcp.js --version