tasqr-mcp (Python)

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

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

インストール

Python 3.11 以降が必要です。

uvx tasqr-mcp        # run once without installing
# or
pip install tasqr-mcp

Related MCP server: tasqr-mcp

MCP クライアント設定

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

資格情報

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

uvx tasqr-mcp

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

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

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

[default]
api_key = tasqr_abc123...

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

サインアップは対話式のため、stdin が TTY の場合にのみ実行されます。ヘッドレスでプロキシを起動する MCP クライアントでキーがない場合は、終了してターミナルで uvx 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 キーが必要です。

資格情報ファイルに kms_key_id を追加すると有効になります。他にインストールするものはありません:

[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 を自ら生成し、作成呼び出しとともに送信します。

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

ローカル開発

pip install -e ".[dev]"
pytest
tasqr-mcp --version