supprecord

supprecord

supprecord は、FormulaSignal のホスト型 MCP サーバーへの小規模なローカルブリッジです。このサーバーは、対象を明確に定めた米国のプレワークアウトサプリメントについて、日付付きのエビデンス記録を管理しています。記録には、対象となる各製品が現在表示している内容、処方が変更されたかどうか、確認済みの各変更を裏付けるエビデンスが含まれます。

このブリッジは独自の記録を保持しません。稼働中のエンドポイントから取得したとおりに、上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。提供する機能の大半は読み取りです。書き込み操作は、呼び出し元自身のウォッチリストへの追加と削除のみです。

ツール

• record.search — 記録から、範囲を限定した自然言語の質問に回答します。必須：query（300 文字以内）。
• products.resolve — ブランド、製品名、または別名から、対象となる正規の製品を 1 つ特定します。必須：identifier。
• products.get — 1 製品の現在の記録を返します。製品情報、1 回分の設定、表示成分、取得時の価格情報、鮮度が含まれます。必須：product_id。
• products.history — 1 製品の過去のタイムラインを返します。各状態は、それが裏付けられる内容に基づいて分類されます。必須：product_id。
• signals.explain — 承認済みシグナルを 1 つ説明します。変更前の状態、変更後の状態、観測期間、エビデンスが含まれます。必須：signal_id。
• signals.list — 承認済みシグナルをリリース順（新しいものから）に返し、増分ポーリングに使用できます。すべてのフィルターは任意です：since、until、product_id、brand、dimension、category、limit、cursor。
• products.compare — 対象製品 2～3 件を、一貫した基準で比較します。必須：product_ids（ID 2～3 件）。
• products.serving_economics — 1 製品について、取得時の商業情報と決定論的な価格計算を返します。必須：product_id。
• ingredients.research — 指定した成分について、選択されたエビデンスセットで使用されている用量範囲を、引用と制限事項とともに返します。任意：ingredient_ids（最大 5 件）または product_id のいずれか。両方は指定できません。
• ingredients.regulatory — 指定した成分の規制記録と文書化された注意事項を返します。任意：ingredient_ids（最大 5 件）または product_id のいずれか。両方は指定できません。
• signals.snapshot — 指定期間における承認済みシグナルとカバレッジ状況の、範囲を限定した概要を返します。任意：from、to、limit、cursor。
• ledger.list — 公開済みの Category Ledger 版を一覧表示します。引数は不要です。
• ledger.get — Category Ledger 版を 1 つ返します。必須：edition_id。
• watchlist.list — キーが紐付けられたアカウントのウォッチリストを、各製品の監視状況とともに返します。引数は不要です。
• watchlist.add — 対象製品を 1 つ、紐付けられたアカウントのウォッチリストに追加します。必須：product_id。
• watchlist.remove — 製品を 1 つ、紐付けられたアカウントのウォッチリストから削除します。必須：product_id。
• watchlist.receipt — 1 期間分の監視レシートを返します。任意：period（YYYY-MM）。
• record.version — 公開記録のバージョン、方法論のバージョン、対応カテゴリ、カバレッジ件数、ソースの鮮度を返します。引数は不要です。

設定

• FORMULASIGNAL_MCP_URL（任意） — 上流エンドポイントを上書きします。デフォルトは https://formulasignal.com/mcp です。（この上書きフックは、この再構築独自のものとして明示されています。）
• FORMULASIGNAL_API_KEY（任意） — 設定すると、すべての上流リクエストに Authorization: Bearer <key> ヘッダーが含まれます。未設定の場合、認証ヘッダーは送信されません。（この転送機能も再構築独自のものとして明示されています。元のインターフェースはキーなしで取得されました。）

転送の仕組み

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

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

CLI

各ツールは、JSON 引数の文字列を 1 つ取るサブコマンドとしても利用できます （引数を必要としないツールでは省略します）。ツール名にはドットが含まれており、 以下に示すとおりそのまま使用します。

npx @reneturcios/supprecord record.search '{"query":"How much caffeine is in C4 Original?"}'
npx @reneturcios/supprecord products.resolve '{"identifier":"C4 Original"}'
npx @reneturcios/supprecord products.get '{"product_id":"example-id"}'
npx @reneturcios/supprecord signals.list '{"limit":10}'
npx @reneturcios/supprecord ledger.list
npx @reneturcios/supprecord --version

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

MCP サーバー

npx -y @reneturcios/supprecord mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

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

ライセンス

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