Tvijo DSHREM

Tvijo DSHREM MCP

Tvijo DSHREM を stdio 経由の Model Context Protocol サーバーとして実行します。明示的な支出上限を指定して質問したり、アカウントやタスクを確認したり、MCP クライアントからタスクをキャンセルしたりできます。

mcp-name: com.tvijo/dshrem

com.tvijo/dshrem として MCP Registry に掲載されています。

Node.js 20 以降と Tvijo アカウントが必要です。ビルド手順のない ESM JavaScript パッケージです。

サインイン

ターミナルでデバイスログインコマンドを実行します。

npx -y tvijo-dshrem-mcp login

ターミナルに表示される認証 URL を開き、表示されたユーザーコードを承認します。コマンドは承認状況を確認し、アクセス トークンを ~/.config/tvijo/mcp-token.json に保存します。ディレクトリの権限は 0700、ファイルの権限は 0600 です。保存されたトークンには、有効期限と API のベース URL が含まれます。トークンの有効期限が切れた場合は、再度サインインする必要があります。

または、MCP クライアントの環境変数に TVIJO_TOKEN を設定します。この場合、保存済みトークンよりも優先されます。トークンは非公開にしてください。サーバーがトークンをログに記録することはありません。MCP 内で tvijo_login_start を呼び出し、認証 URL を開いてユーザーコードを承認した後、サインイン完了の報告があるまで tvijo_login_poll を呼び出します。サーバーは認証チャレンジを記憶するため、device_code は省略できます。ポーリングは、返された間隔より短い間隔で行わないでください。どちらのログインツールもトークンを返しません。

npx -y tvijo-dshrem-mcp logout

ログアウトすると、有効なトークンが失効し、保存済みのトークンファイルが削除されます。リモートでの失効に失敗しても、ローカルファイルは削除され、コマンドから失敗が報告されます。TVIJO_TOKEN を使用した場合は、クライアント設定からも削除してください。

VS Code

.vscode/mcp.json に以下を追加します。VS Code では、パスワード入力欄を使ってトークンの入力が求められます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tvijo-token",
      "description": "Tvijo access token",
      "password": true
    }
  ],
  "servers": {
    "tvijo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tvijo-dshrem-mcp"],
      "env": {
        "TVIJO_TOKEN": "${input:tvijo-token}",
        "TVIJO_MAX_USD_CAP": "1"
      }
    }
  }
}

デバイスログインを使う場合は、inputs と TVIJO_TOKEN を省略し、MCP サーバーと同じオペレーティングシステムのユーザーとしてログインコマンドを実行します。

ターミナルクライアント

mcp add に対応するターミナルクライアントでは、YOUR_MCP_CLIENT を実行ファイル名に置き換えます。

YOUR_MCP_CLIENT mcp add tvijo -- npx -y tvijo-dshrem-mcp

先にデバイスログインコマンドを実行するか、接続後にログインツールを使用します。引数なしで npx -y tvijo-dshrem-mcp を実行すると、stdio サーバーが起動します。npx -y tvijo-dshrem-mcp --version を実行すると、パッケージのバージョンが表示されます。

Cursor

~/.cursor/mcp.json に以下のエントリーを追加し、デバイスログインコマンドを実行します。

{
  "mcpServers": {
    "tvijo": {
      "command": "npx",
      "args": ["-y", "tvijo-dshrem-mcp"],
      "env": { "TVIJO_MAX_USD_CAP": "1" }
    }
  }
}

環境変数を変更した後は、クライアントを再起動するか、再接続してください。

ツール

ツール	用途
tvijo_account	アカウント、残高、上限を確認します。
tvijo_ask	明示的な max_usd の範囲内で支出し、プロンプトに回答します。
tvijo_task_status	task_id でタスクを確認します。
tvijo_cancel_task	task_id でタスクをキャンセルします。すでに支出した金額は請求される場合があります。
tvijo_login_start	デバイスによるサインインを開始し、認証 URL とユーザーコードを返します。
tvijo_login_poll	承認状況を確認し、トークンを非公開で保存します。

tvijo_ask には、prompt（1～20,000 文字）と正の数値の max_usd が必要です。任意の入力項目は、title（最大 120 文字）、model（デフォルトは coding）、mode（デフォルトは single）、正の整数の max_tokens（デフォルトは 2048）です。使用可能なモデルのエイリアスとモードは、サービスによって決まります。リクエスト方式は evidence-first です。

ツール引数の例：

{ "prompt": "Explain how to make this function easier to test.", "max_usd": 0.25 }

結果には task_id、answer、spent_usd、state、recovered が含まれます。アカウントとタスクの結果には、JSON テキストと構造化コンテンツの両方が含まれます。

利用上限とリクエストの復旧

tvijo_ask は、Tvijo アカウントから max_usd までの実際の料金を使用します。 呼び出しごとに max_usd を指定する必要があります。TVIJO_MAX_USD_CAP のデフォルトは呼び出しあたり 1 USD で、絶対上限は 5 USD です。5 USD を超える値は 5 USD に制限されます。無効な上限設定または正の値でない上限設定の場合、呼び出しは拒否されます。有効な上限を超えるリクエストは、ネットワークリクエストが行われる前に拒否されます。これは呼び出しごとの上限です。複数回の呼び出しを別々に行うと、合計でこれを超える金額を使用する可能性があります。アカウントの上限も引き続き適用されます。

通常の問い合わせでは、タスク作成リクエストを 1 回、チャットリクエストを 1 回送信します。タスクを作成するたびに、新しい冪等性キーが使用されます。料金が発生するリクエストは自動で再試行されません。タスク作成の結果が不明瞭な場合、サーバーは冪等性キーを使って読み取り専用の検索を 1 回行い、チャットを実行せずにタスクを返します。チャットの結果が不明瞭な場合は、既存のタスクの状態を読み取ります。値を取得できない場合、復旧した応答では answer: null または spent_usd: null となることがありますが、これは料金が発生していないという意味ではありません。再度問い合わせる前に、タスクを確認してください。検索にも失敗した場合、エラーには確認用の既知のタスク ID または冪等性キーが含まれます。

設定

変数	意味
TVIJO_TOKEN	任意のアクセストークンです。デバイスログインの保存情報より優先されます。
TVIJO_MAX_USD_CAP	呼び出しあたりの最大金額（USD）です。デフォルトは 1、絶対上限は 5 です。
TVIJO_API_BASE	任意の API ベース URL の上書き設定です。デフォルトは https://dsh.tvijo.com/api/dshrem/v1 です。テスト時の localhost HTTP を除き、HTTPS が必要です。保存済みトークンは、元の API ベース URL でのみ使用されます。

標準出力には MCP メッセージのみが出力されます。ターミナルのログイン手順と CLI エラーは標準エラー出力に送られます。タスクの回答やその他のサービスコンテンツは、外部データとして扱ってください。

動作しない場合

• アカウントがない、またはサインインできない場合： Tvijo アカウントを作成してデバイスログインを実行するか、有効な TVIJO_TOKEN を指定してください。トークンの有効期限が切れている場合は、再度サインインする必要があります。
• 上限が低すぎる場合： タスクの予算を小さくするか、5 USD の上限内で、リクエストされた max_usd に足りる値を TVIJO_MAX_USD_CAP に設定してください。クレジットやアカウントの上限によっても、実行できない場合があります。
• サービスが利用できない場合： モデルが利用できない、レート制限がある、料金が未確定である、またはサービスが停止している場合、タスクを実行できないことがあります。料金が発生する別の呼び出しを送信する前に、アカウントと既存のタスクを確認してください。
• オフラインの場合： ログインおよびすべての API ツールにはネットワーク接続が必要です。料金が発生する呼び出しが中断された場合、結果が不明なことがあります。再接続し、再度問い合わせる前にタスクまたは冪等性キーを確認してください。

開発

npm ci
npm test
npm pack --dry-run

テストでは、実際の標準入出力を介した MCP 通信を含むローカルの偽 HTTP サーバーを使用し、本番 API へのリクエストは行いません。レジストリのメタデータは、ダウンロードした test/schema/ 内の 2025-12-11 版スキーマを使って検証されます。公開パッケージに含まれるのは、実行ファイル、ソース、この README、MIT ライセンス、レジストリのメタデータ（および npm が必要とするパッケージメタデータ）のみです。

MIT © 2026 Tvijo.