stockdata-mcp

株式調査のためのMCPサーバー。2つのバックエンド、1つのツールサーフェス。

この分割は意図的です。QualtrimはFMPの顧客です。生データを購入し、レイヤーを追加します。したがって、このサーバーは生のものはすべてFMPに直接アクセスし、Qualtrimの呼び出しはQualtrim独自のものにのみ使用します。

52ツール — 30 FMP、22 Qualtrim。

Qualtrimバックエンドを有効にする前に

このサーバーのFMP側は普通です。ドキュメント化された公開API、サインアップするキー、好きなように使えます。

Qualtrim側はそうではありません。QualtrimはAPIを公開していません — それらのルートは彼らの出荷されたJavaScriptから読み取られたものであり、彼らの利用規約は、プラットフォームのリバースエンジニアリングと、事前の書面による同意なしに 自動化された手段でデータを取得することを禁止しています。

その同意は譲渡できず、このリポジトリはそれを付与しません。Qualtrimバックエンドを実行したい場合は、独自の有料Qualtrimアカウント と、自分で取得したQualtrimからの書面による許可 が必要です。support@qualtrim.com に直接問い合わせてください。

それがない場合は、QUALTRIM_USERNAME/QUALTRIM_PASSWORD を設定せずにサーバーを実行してください。FMPツールは単独で問題なく動作し、ここでQualtrimに依存するものはありません。

このコードは、そのようなクライアントがどのように構成されているかの参考として公開されており、誰かのサービスに向けるための招待状ではありません。Qualtrimの違反に対する表明された救済策はアカウントの終了であり、彼らの手数料は返金不可です。

インストール

cd ~/Projects/stockdata-mcp
uv venv && uv pip install -e .
./scripts/set-credentials.sh          # prompts; password input is hidden

set-credentials.sh は 0600 パーミッションで .env を書き込みます。gitignoreされています。 無料のFMPキーを https://site.financialmodelingprep.com/developer/docs で取得してください。

マシン上のすべてのセッションで一度だけ登録します:

claude mcp add stockdata --scope user -- ~/Projects/stockdata-mcp/.venv/bin/stockdata-mcp

-e フラグは不要 — サーバーは .env を自分で読み取るため、資格情報は ~/.claude.json に残りません。実際の環境変数はファイルを上書きするため、MCPクライアントは必要に応じて -e を渡すことができます。

任意のセッションから backend_status で確認できます。

モデルへのガイダンス

サーバーはMCPプロトコルを介して独自の使用手順を提供します — バックエンドの選択、無料層の制限、Qualtrimの癖、数値の報告方法。すべてのMCPクライアントは、追加設定なしでこれらを自動的に受け取ります。

また、.claude/skills/stock-research/ に、より詳細なスキルがあり、調査ワークフローをより深くカバーしています。Claude Codeは ~/.claude/skills/ から読み取ります(そこにシンボリックリンクします)。Claude Desktopはスキルを独自の場所で管理し、そのディレクトリからは取得しません — 上記のサーバー手順に依存しており、決定に重要な部分が含まれています。

Related MCP server: StocksMCP

キャッシュと予算

応答は ~/.cache/stockdata-mcp/cache.db のSQLiteストアにキャッシュされます。ストアは グローバルであり、クライアントごとではありません — このユーザーのすべてのサーバープロセスが同じファイルを開くため、Claude CodeとClaude Desktopは1つのキャッシュと1つの日次合計を共有します。これは効率性だけでなく、正確性のために必要です: FMPクォータはAPIキーに属し、両方のアプリが同じキーを使用します。

TTLはエンドポイントごとに選択されます。クォートは1分、プロファイルは1週間、参照データは1か月。日付範囲が今日より前に終了した履歴バーは期限切れになりません。過去に発生した終値は変更できないためです。今日まで続く範囲はまだ移動するエッジがあり、15分間のTTLが適用されます。

3つのツールがこれを管理します:

estimate_cost は、ツールとリクエストの比率が1:1ではなく、呼び出し側からは見えないため存在します: fmp_search は2リクエスト、fmp_price_target は3、fmp_quote は無料キーではシンボルごとに1つ。最悪のリクエスト数、すでにキャッシュされているレッグ数、今日の残り予算に対する純額を報告します。検証済み: その予測は、混合5呼び出しプランで実際の支出と正確に一致し、同じプランをウォームで再実行した場合は0を返しました。

同じシンボルを同時に要求する6つの独立したプロセスで測定: 1つの上流リクエスト、5つのキャッシュヒット、ロックの競合なし。

設定

FMPツール

検索と参照: fmp_search、fmp_profile、fmp_quote、fmp_peers、fmp_reference。

ファンダメンタルズ: fmp_income_statement、fmp_balance_sheet、fmp_cash_flow、fmp_key_metrics、fmp_ratios、fmp_financial_growth、fmp_financial_scores、fmp_revenue_segmentation、fmp_enterprise_values。

アナリストと評価: fmp_analyst_estimates、fmp_price_target、fmp_grades、fmp_dcf。

イベントと市場: fmp_dividends、fmp_earnings、fmp_earnings_calendar、fmp_historical_prices、fmp_technical_indicator、fmp_screener、fmp_market_movers、fmp_sector_performance、fmp_insider_trading、fmp_news。

fmp_request(endpoint, params) は、FMPの約250の安定したエンドポイント — ETF保有、13F、上院取引、経済指標、SEC提出書類、トランスクリプト — に専用のラッパーなしで到達します。

無料層が実際にカバーするもの

ライブの無料キーで検証済み: 29ツールのうち22が動作します。

有料プランが必要: fmp_screener、fmp_reference、fmp_news、fmp_insider_trading、fmp_technical_indicator。それぞれが原因としてプランを明示する明確なエラーを返します。

2つの注意点:

• 複数シンボルの fmp_quote は、バッチルートが有料であるため、シンボルごとのリクエストにフォールバックします。日次クォータを保護するために20シンボルに制限されています。

• fmp_technical_indicator が有料であることは簡単に回避できます — fmp_historical_prices は無料であるため、インジケーターはOHLCVからローカルで計算できます。

無料層は1日あたり約250リクエストを許可します。limit と from_date/to_date を渡してください。価格履歴のデフォルトはシリーズ全体です。

Qualtrimツール

シンボルごと: qualtrim_overview、qualtrim_profile、qualtrim_quote、qualtrim_dcf、qualtrim_kpi_charts、qualtrim_chart、qualtrim_ai_analysis、qualtrim_analyst_estimates。

比較: qualtrim_available_kpis、qualtrim_compare。

あなたのアカウント: qualtrim_portfolios、qualtrim_portfolio、qualtrim_portfolio_look_through_earnings、qualtrim_portfolio_ai_analysis、qualtrim_portfolio_dividends、qualtrim_watchlists、qualtrim_watchlist、qualtrim_dip_finder、qualtrim_watchlist_valuation_ranges。

エスケープハッチ: qualtrim_request(path)、GETのみ。

書き込み (qualtrim_add_watchlist_stock、qualtrim_add_portfolio_holding) は、QUALTRIM_ENABLE_WRITES=true でない限り実行を拒否します。

Qualtrim認証が実際にどのように機能するか

彼らの配信されたバンドルはベアラートークン認証のように見えます — authTokens が localStorage に、Authorization: Bearer。実際はそうではありません。ログインはユーザーオブジェクトを返し、Expressセッションクッキー (connect.sid) を設定します。そのクッキーが通常のリクエストを承認します。バンドルのトークンパスは、そのリフレッシュ呼び出しによってのみ実行されます。

このクライアントはクッキージャーを保持し、セッションを ~/.cache/stockdata-mcp/qualtrim-session.json (0600) にキャッシュし、401で自動的に再度ログインします。

既知のドリフト

彼らのデプロイされたバックエンドは、ルートが読み取られたバンドルからすでに分岐しています:

両方のツールはすでに動作するバリアントを使用しています。時間の経過とともにさらに多くのことを期待してください — Qualtrimツールからの404は、ルートが移動したことを意味し、ティッカーが間違っていることを意味しません。

qualtrim_dcf が空を返すのは失敗ではありません。アカウント内のそのシンボルにDCFが保存されていないことを意味します。

Qualtrimとその利用規約

QualtrimはAPIを公開していません。これらのルートは彼らの配信されたJavaScriptから読み取られました。2つの結果:

予告なく壊れる可能性があります。 上記の「既知のドリフト」を参照してください — すでに発生しています。

彼らの条件によって制限されています。 彼らの許容使用セクションは、事前の書面同意なしに自動化された手段でサイトからデータを体系的に取得することを禁止し、プラットフォームのリバースエンジニアリングを別途禁止しています。彼らの執行レバーはアカウントの終了であり、彼らの手数料は返金不可です。

同意は取得可能です — 禁止はそれに条件付きです。support@qualtrim.com でQualtrimに直接問い合わせ、彼らの返信を保管してください。

ここでのデフォルトは控えめです: 1リクエスト/秒、最大2同時、ブラウザに一致するユーザーエージェント、デフォルトでGET、バルク列挙なし。インタラクティブな研究量に保ってください。

レイアウト

src/stockdata_mcp/
  server.py     tool definitions for both backends
  fmp.py        FMP stable-API client
  qualtrim.py   Qualtrim cookie-session client
  util.py       throttling, response trimming, .env loading
scripts/
  set-credentials.sh
.claude/skills/stock-research/SKILL.md

投資アドバイスではありません

あなた自身の調査のためのデータ。どちらのソースも正確性を保証せず、ここにあるものは売買の推奨ではありません。