claimscope

claimscope

claimscope は、主張や質問を調査するパネル型エンジンである ECCA のホスト型 MCP サーバーへの、薄いローカルブリッジです。単一の モデルの回答を信頼するのではなく、上流サーバーは設定済みのエンジンからの回答を比較し、 意見が分かれる箇所を明らかにします。また、敵対的なプレモーテムや意思決定トーナメントを実施し、 他の AI が作成した候補回答を検証します。さらに、心理学、学習、栄養、金銭に関する 質問では、学術研究を取得して判定の根拠を評価してから、 回答を提示します。

このブリッジ自体は回答を保持せず、評価も行いません。 上流サーバーのツール一覧をローカルで提供します。 これはライブエンドポイントから取得した内容をそのまま保持したものです。 各ツール呼び出しを上流サーバーに転送し、結果を変更せずに返します。 取得した一部のツールの説明には「キー付きティア別クォータ枠」とありますが、これは上流サーバー独自の 表現であり、そのまま提供しています。このクライアントは独自のクォータや 決済機能を追加せず、認証情報を送信するのはユーザーが設定した場合のみです（「Configuration」を参照）。

ツール

• ecca_synthesize — 1 つの問い合わせ（query、 必須）について、設定済みのエンジンからの回答を比較し、 意見の相違を調べます。測定可能な場合は、語彙的な 類似度と最終回答の一致度を確認します。 オプション：model（結果に表示されるラベル）、 depth（1 つのエンジンを使う高速ルートから複数エンジンを使う詳細ルートまで）、 antagonist（1 つのエンジンを強制的にレッドチームの役割にする）。
• ecca_pre_mortem — 計画や前提（premise、 必須）の失敗をシミュレートしてストレステストします。 失敗モードと早期警告指標を提示し、 経験的な議論の検証を行います。オプション： horizonMonths（デフォルトは 18）。
• ecca_decision_tournament — 意思決定の文脈 （decisionContext、必須）において、離散的な選択肢 （options、必須）を、ミニマックス後悔と パレート順位付けを使って評価します。
• ecca_bts_divergence — 候補となる assertions（必須）の間の語彙的・意味的な 相違を測定し、迎合的な類似回答にペナルティを課します。
• ecca_refine — 事実を追加せずに、粗い質問（text、 必須、最大 2000 文字）を明確にします。 検出したニッチ分野と、質問を洗練するための選択肢を返します。
• ecca_research — question（必須）に関する学術インデックスから研究を取得して 評価し、取得した根拠と明示的な不足点を返します。 オプション：niche（psychology、learning、 nutrition、money のいずれか）。
• ecca_verify — question と candidate_answer（どちらも必須）について、 独立して回答し、決定論的なパネルの一致度と照合して、 名前付きの異論を示します。
• ecca_psychology — 心理学に関する question（必須）を 洗練し、研究を取得して、判定の前に名前付きの主張を示します。
• ecca_learning — 学習または勉強のスキルに関する question（必須）に、 同じ根拠と主張の処理を行います。
• ecca_nutrition — 栄養またはサプリメントに関する question（必須）に、同じ処理を行います。
• ecca_money — 金銭またはビジネスに関する question（必須）に、 同じ処理を行います。
• ecca_claim_protocol_validate — ecca.claim-protocol 1.0 の document（必須）を 形式のみについて検査します。バージョン、ベンダー名ではなくエンジンスロットを使っているか、 公開済みの分類から原因を選んでいるか、質問文への同意があるか、封印があるかを確認します。 エラー一覧とともに ok を返します。検証するのは ドキュメントの形式のみであり、その背後にある記録は検証しません。

設定

• ECCA_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://eccaai.com/api/mcp です。 （この上書きフックは、この再構築で独自にラベル付けしたものです。）
• ECCA_API_KEY（任意）— 設定すると、上流へのすべてのリクエストに Authorization: Bearer <key> が含まれます。未設定の場合、認証ヘッダーは一切送信されません。 この再構築の基となった元の取得データでは、キーは不要でした。 （この認証転送は、この再構築で独自にラベル付けしたものです。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo name claimscope）、続いて notifications/initialized 通知を送信し、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が Mcp-Session-Id ヘッダーを付けて initialize に応答すると、 その値はセッションの後続のすべてのリクエストに付与され、 プロセスが動作している間、同じセッションが再利用されます。 応答は通常の JSON またはサーバー送信イベントとして届くことがあり、 どちらも読み取ります。

上流からの成功した結果は、上流が設定した isError フラグも含め、 そのまま渡されます。 失敗（JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、 または完了できないリクエスト）は、テキストが claimscope error: で始まる isError 結果として返されます （この形式は、この再構築で独自にラベルを付けたものです）。

CLI

各ツールは、JSON 引数文字列を受け取るサブコマンドでもあります。

npx @reneturcios/claimscope ecca_verify '{"question":"does spaced repetition work?","candidate_answer":"yes, robustly"}'
npx @reneturcios/claimscope ecca_decision_tournament '{"decisionContext":"hire or contract","options":["hire","contract","defer"]}'
npx @reneturcios/claimscope ecca_refine '{"text":"why do i forget things"}'
npx @reneturcios/claimscope --version

終了コード：成功時は 0、isError の結果の場合は 1、使用方法の 誤りの場合は 2 です。

MCP サーバー

npx -y @reneturcios/claimscope mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "claimscope": {
      "command": "npx",
      "args": ["-y", "@reneturcios/claimscope", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/claimscope
docker run --rm ghcr.io/cloudcorprecords/claimscope --version

コンテナのデフォルトコマンドは mcp です。そのため、最初の形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは、スタブ化した JSON-RPC 上流のみを対象に実行されます。 実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。