valueledger

valueledger

valueledgerは、FolioFactのホスト型MCPサーバーへの小規模なローカルブリッジです。バリュー投資家向けの読み取り専用リサーチサービスであり、よく知られたファンドとその投資家を追跡し、四半期ごとに13F形式の保有銘柄を追い、さらに企業の財務情報、決算レポート、インサイダー取引、オプションデータを重ねて提供します。

このブリッジはリサーチデータを独自には保持しません。稼働中のエンドポイントから取得したとおりに、上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流へ転送して、結果を変更せずに返します。取得対象のすべてのツールは読み取り専用です。取引の発注、資金の移動、外部への情報送信を行うものはありません。

ツール

• search — ファンド、株式、インサイダー取引を対象とした、範囲を限定した横断検索です。任意：query。
• get_fund — 追跡対象ファンド1件の最新の提出書類と、その投資家を取得します。必須：slug。
• fund_holdings — ファンドの現在のポートフォリオ保有銘柄と、前四半期からの変化を取得します。必須：slug。
• fund_history — 四半期ごとの提出書類の履歴に加え、売買回転率、集中度、お気に入りの概要を取得します。 必須：slug。
• get_stock — 追跡対象ファンドが保有する企業1社について、保有者、評価額、前四半期からの変動を取得します。必須： ticker。
• get_investor — 投資家1人のポートフォリオへのリンクと、注目ファンドを取得します。必須：slug。
• insider_feed — 保有銘柄すべてに関する最近のForm 4／5インサイダー取引を、新しい順に取得します。任意： filter、q、page、per_page、sort、dir。
• fetch_page — 許可リストに登録された公開ページ（ブログ記事、静的ページ、エージェント検出ドキュメント）を、Markdownまたはテキストとして取得します。必須：path。
• stock_earnings — ある株式に関する、最新の引用付きAI Earnings Reportを取得します。必須：ticker、任意：period、 include_full。
• stock_financials — ある株式の財務諸表（年次および四半期）と評価サマリーを取得します。 必須：ticker。
• stock_insiders — ある企業の最近のForm 4／5インサイダー取引を取得します。必須：ticker。
• stock_options — ある企業の日次30日インプライド・ボラティリティ履歴を取得します。必須：ticker。
• compare_stocks — 2～6銘柄を並べて比較します。評価額、最新の財務データ、ファンドの確信度、インサイダー活動を比較します。必須：tickers、 任意：insider_window。

株式単位のツールの一部は、上流の説明でFolioFact Proが必要とされています。ブリッジはどちらの場合も呼び出しを転送し、上流の回答を変更せずにそのまま返します。

設定

• FOLIOFACT_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://foliofact.com/mcp です。 （この上書きフックは、本再構築で独自に明示したものです。）
• FOLIOFACT_API_KEY（任意）— 設定すると、すべての上流リクエストに X-Api-Key: <key> ヘッダーが付加されます （ヘッダー名は上流のレジストリレコードに基づきます）。未設定の場合、キーのヘッダーは送信されません。 （この変数からキーを転送する処理も、本再構築で独自に明示したものです。元のサーフェスはキーなしで取得されました。）

転送の仕組み

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

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

CLI

各ツールは、JSON 引数を 1 つ取るサブコマンドでもあります （引数を必要としないツールでは省略します）。

npx @reneturcios/valueledger search '{"query":"Pabrai"}'
npx @reneturcios/valueledger get_fund '{"slug":"pabrai-funds"}'
npx @reneturcios/valueledger get_stock '{"ticker":"BRK.A"}'
npx @reneturcios/valueledger compare_stocks '{"tickers":"AAPL,MSFT,GOOG"}'
npx @reneturcios/valueledger --version

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

MCP サーバー

npx -y @reneturcios/valueledger mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

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