mcpField
T
TickerDB

TickerDB

リモート
github.com/tickerdb金融データ58 週間前に更新
リポジトリ

TickerDB について

TickerDBは、株式、ETF、暗号資産ペアを分析するエージェント向けの市場データMCPサーバーです。事前計算済みの指標状態や過去の推移、その後の値動きの統計を価格データとともに提供します。

主な機能

  1. 01テクニカル・ファンダメンタルズの事前計算済み状態
  2. 02状態遷移とその後の値動きの過去統計
  3. 03日次・週次のOHLCVデータ
  4. 04状態による絞り込みと項目別ランキング
  5. 05ウォッチリストの概要と変化の追跡

活用シーン

  1. 01サポート付近の売られ過ぎ銘柄の抽出
  2. 02指標状態の発生後の過去の値動きの確認
  3. 03保存済みウォッチリストの変化の追跡

MCP 対応

ホスト型のStreamable HTTPサーバー、またはstdioを使うローカルnpmパッケージを通じて、MCPクライアントに市場データツールを提供します。ホスト型エンドポイントはOAuth 2.1とBearer token認証に対応します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.tickerdb.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

パッケージ
npmtickerdb-mcp1.8.6

ツール

9
パラメーター型必須説明
endstringいいえ範囲の終了日(YYYY-MM-DD)。過去系列を取得する場合は start と併用します。
bandstringいいえイベントを特定のバンド値(例:deep_oversold、strong_uptrend、stage_2_growth)で絞り込みます。trend_distance_ma40 などの MA 距離イベントフィールドでは、above と below のグループ別名も使用できます。field と併用する場合のみ有効です。
datestringいいえ特定時点のスナップショットに使用する過去の日付(YYYY-MM-DD)。Plus または Pro プランが必要です。省略すると最新データを取得します。
metabooleanいいえスナップショットモードと過去データモードでのみ使用します。true を指定すると、レスポンス全体に同階層の _meta / status_meta 安定性オブジェクトを含めます。このフラグがなくても、fields で明示的に指定した *_meta フィールドパスは有効です。
afterstringいいえこの日付(YYYY-MM-DD)より後のイベントを返します。field と併用する場合のみ有効です。
fieldstringいいえイベントクエリのバンドフィールド名(例:momentum_rsi_zone、extremes_condition、trend_direction、trend_stage、pattern_bull_flag、pattern_ascending_triangle、pattern_rising_wedge、trend_ma8_slope から trend_ma200_slope、trend_ma_crossover_event、trend_distance_ma40、fundamentals_valuation_zone、fundamentals_free_cash_flow、insider_zone、sector_rsi_zone、momentum_divergence_detected、fundamentals_analyst_consensus)。指定すると、スナップショットの代わりにバンド遷移履歴を返します。
limitintegerいいえイベントモード:最大結果数(1~50)。デフォルトでは新しい順に返します。sample=even の日付範囲モード:要求するサンプル行数。プランごとの上限があります(Free 3、Plus 10、Pro 50)。
startstringいいえ範囲の開始日(YYYY-MM-DD)。過去系列を取得する場合は end と併用します。
statsbooleanいいえイベントモードでのみ使用します。true を指定すると、生のイベント行の代わりに集計統計を返します。
beforestringいいえこの日付(YYYY-MM-DD)より前のイベントを返します。field と併用する場合のみ有効です。
fieldsarrayいいえ返す任意のサマリーフィールド。market_cap や market_cap_tier などの識別フィールドは常に含まれます。ohlcv、trend、momentum、volatility、volume、patterns、extremes、support_level、resistance_level、fundamentals、sector_context、levels(有料プラン)などのセクションを指定できます。または、ohlcv.close、trend.direction、trend.stage、trend.ma_slopes.ma_8、trend.ma_slopes.ma_20、trend.ma_slopes.ma_40、trend.ma_slopes.ma_50、trend.ma_slopes.ma_100、trend.ma_slopes.ma_200、trend.moving_average_values.ma_8、trend.ma_crossover_event、trend.direction_meta、trend.distance_from_ma_band.ma_40、trend.volume_confirmation、momentum.rsi、momentum.rsi_zone、momentum.stochastic_k、momentum.stochastic_d、momentum.stochastic_zone、momentum.xtrm_score、momentum.divergence_detected、momentum.divergence_type、momentum.macd_state、patterns.bull_flag、patterns.bull_flag_breakout、patterns.bear_flag、patterns.bear_flag_breakdown、patterns.ascending_triangle、patterns.rising_wedge、volatility.squeeze_active、volatility.squeeze_days、volatility.regime_trend、volume.climax_detected、volume.climax_type、volume.accumulation_state、volume.price_direction_on_volume、support_level.level_price、support_level.status_meta、resistance_level.level_price、sector_context.rsi_zone、sector_context.trend、sector_context.agreement、sector_context.asset_vs_sector_rsi、sector_context.asset_vs_sector_trend、sector_context.oversold_count、sector_context.valuation_zone、fundamentals.pe_ratio、fundamentals.valuation_zone、fundamentals.growth_zone、fundamentals.free_cash_flow、fundamentals.earnings_proximity、fundamentals.earnings_proximity_basis、fundamentals.last_earnings_surprise、fundamentals.analyst_consensus、fundamentals.analyst_consensus_direction、fundamentals.valuation_percentile、fundamentals.pe_vs_historical_zone、fundamentals.pe_vs_sector_zone、fundamentals.insider_activity、fundamentals.insider_activity.zone、fundamentals.insider_activity.net_direction、levels、levels.support_levels、levels.resistance_levels などのドット区切りパスも指定できます。週次スナップショットでステージを示す根拠が十分な場合、trend.stage が設定されます。イベントフィールドには、momentum_rsi_zone、extremes_condition、trend_stage、pattern_bull_flag、pattern_ascending_triangle、pattern_rising_wedge、trend_ma8_slope から trend_ma200_slope、trend_ma_crossover_event、trend_distance_ma40、fundamentals_valuation_zone、fundamentals_free_cash_flow、insider_zone、sector_rsi_zone、momentum_divergence_detected、fundamentals_analyst_consensus など、完全なスキーマ名を優先してください。
sampleenumいいえ日付範囲モードでのみ使用します。'even' を指定すると、start/end の全範囲にわたってスナップショットを均等に分散します。even
tickerstringはいティッカーシンボル(例:AAPL、BTCUSD、SPY)
timeframeenumいいえ分析の時間枠。デフォルト:dailydaily | weekly
context_bandstringいいえコンテキストのティッカーがこのバンドにある場合のイベントのみを返します(例:downtrend)。MA 距離のコンテキストフィールドでは、above と below のグループ別名も使用できます。context_ticker および context_field と併せて指定する必要があります。
context_fieldstringいいえcontext ticker で確認する Band フィールド(trend_direction、trend_stage、trend_distance_ma40 など)。context_ticker および context_band と併せて指定してください。
context_tickerstringいいえクロスアセット相関:フィルター対象となる 2 つ目の ticker(例:SPY)。context_field と context_band が必要です。Plus/Pro のみ。

詳細

TickerDB — エージェント向け株式市場データ。

AI エージェント向けに事前計算された株式市場データです。TickerDB は trend_direction、support_level、analyst_consensus などの指標を名前付きの状態として返し、さらに何が変化したか、そして通常その後に何が起こるかも示します。

米国株、ETF、暗号資産ペアを10,000銘柄以上収録 · トレンド、モメンタム、ボラティリティ、出来高、パターン、サポート/レジスタンス、ファンダメンタルズ、セクター情報にわたる182の指標 · 7年分の履歴 · tickerdb.com

ツール

ツール説明
get_summaryティッカーのテクニカルおよびファンダメンタルズのスナップショット。過去のデータ参照、状態遷移履歴、通常その後に起こること
get_ohlcvリターン、チャート、バックテスト向けの日次または週次のEODローソク足
get_searchカテゴリ別の状態で資産をスクリーニングしたり、market_cap や pe_ratio などのフィールドでランク付けしたりします
get_schema182個すべてのフィールドと、有効なバンド値を確認します
get_watchlist保存したウォッチリストにあるすべてのティッカーの包括的な分析サマリー
get_watchlist_changesウォッチリストで変化した内容を、前日比または前週比で表示します
add_to_watchlistティッカーをウォッチリストに追加します
remove_from_watchlistティッカーをウォッチリストから削除します
get_accountアカウントの詳細、プランのティア、使用状況

すべてのツールはすべてのティア(Free、Plus、Pro)で利用できます。ティアによって、クレジット上限、履歴の範囲、フィルター数、ウォッチリストのサイズが異なります。tickerdb.com/pricingをご覧ください。

クイックスタート

TickerDB を Claude、ChatGPT、または別の MCP クライアントに接続し(以下のセットアップを参照)、次のように試してください。

「サポート付近にある売られ過ぎの大型株を表示して」

エージェントは momentum_rsi_zone = oversold および market_cap_tier in [large, mega] のフィルターを指定して get_search を呼び出し、続いて個々の結果に対して get_summary を呼び出します。生の数値を計算する必要はありません。エージェントはカテゴリ別の状態を読み取り、それらを直接推論します。

「AAPLが売られ過ぎになったとき、通常は何が起こる?」

field=momentum_rsi_zone、band=oversold、stats=true を指定した get_summary は、過去7年間の各売られ過ぎ局面の後、5日、10日、20日、50日、100日で株価がどう動いたかを示す、集計された事後分布を返します。

「ウォッチリストで何が変わった?」

get_watchlist_changes は、最後のパイプライン実行以降のフィールド単位の状態遷移のみを返します。バンドへの進入、離脱、変化を報告するため、エージェントはすべてのティッカーの完全なサマリーを取得せずに、変化した内容を報告できます。

OHLCVをそのまま渡すだけでは不十分なのはなぜですか?

モデルは生のバーからRSIを計算できます。しかし、生のOHLCVを渡して「AAPLは強気に見える?」と尋ねると、実際に依頼した分析を行う代わりに、指標を一つずつ計算する演算でコンテキストを消費してしまいます。つまり、機関投資家が買い集めるなかでRSIが売られ過ぎになったばかりであること、押し目は急激でも200日上昇トレンドは維持されていること、インサイダーが四半期を通じて売り続けていることに気づく、という分析です。生のバーでは、こうした情報が計算の裏に埋もれてしまいます。

TickerDB を使えば、モデルは "oversold"、"accumulation"、"strong_uptrend" を確認し、すぐにそれらを結び付けられます。

状態遷移を使えば、さらに踏み込んだ分析ができます。「BTCがこれほど売られ過ぎだった前回は何が起きた?」という問いに答えるには、7年分の日次バーからRSIを計算し、売られ過ぎになったすべての時点を見つけ、その後の値動きを計算する必要があります。TickerDB なら、field=momentum_rsi_zone、band=oversold、stats=true を指定した get_summary を1回呼び出すだけです。

セットアップ

ホステッドサーバー(推奨)

リモートサーバー https://mcp.tickerdb.com/mcp は OAuth 2.1 と Bearer トークン認証に対応しています。Streamable HTTP トランスポートを使用してください(レガシーな SSE は使用しないでください)。

クライアント方法
Claude.aiSettings → Connectors → Add → https://mcp.tickerdb.com/mcp → Authorize
Claude Codeclaude mcp add --transport http --scope user tickerdb https://mcp.tickerdb.com/mcp
ChatGPTPlugins → + → https://mcp.tickerdb.com/mcp → Create → Authorize
Cursor.cursor/mcp.json → {"tickerdb": {"url": "https://mcp.tickerdb.com/mcp"}}
任意の MCP クライアントAuthorization: Bearer tdb_... を指定して https://mcp.tickerdb.com/mcp に Streamable HTTP で接続します
npm パッケージ(ローカル stdio)

ローカルプロセスを使用するクライアント(Claude Desktop など)向け:

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp"],
      "env": {
        "TICKERDB_KEY": "tdb_your_api_key_here"
      }
    }
  }
}

tickerdb.com/dashboard で API キーを取得してください。

構成

3 パッケージからなるモノレポです。

  • shared/ — ツール定義、API クライアント、サーバーファクトリー(内部用)
  • remote/ — mcp.tickerdb.com 上の Cloudflare Worker(Streamable HTTP + OAuth 2.1)
  • local/ — 公開済み npm パッケージ tickerdb-mcp(stdio)

どちらのトランスポートも同じツール定義を使用します。MCP サーバーは薄いプロキシです。アクセス制御、レート制限、フィールドのフィルタリングは TickerDB API が処理します。

認証
  • Bearer トークン — Authorization: Bearer tdb_...
  • OAuth 2.1 — 動的クライアント登録、PKCE、トークン交換、失効に対応します。/authorize は同意画面のために tickerdb.com へリダイレクトします。

認証なしでも initialize と tools/list はツールの検出に使用できます。tools/call には認証が必要で、再認証をスムーズに行えるよう resource_metadata を含む 401 Bearer チャレンジを返します。

セッション戦略

リモート Worker は、意図的にデフォルトでステートレスなトランスポートを使用します。すべてのツールはリクエストとレスポンスがステートレスであり、Cloudflare Worker のメモリは分離された環境ごとにローカルです。ステートレスモードにすることで、エッジでのセッション消失によってコネクターが検出した名前空間が無効になるのを防ぎます。明示的なセッションのデバッグには MCP_SESSION_MODE=stateful を設定してください。

開発

npm install                              # workspace dependencies
npm run build                            # type-check remote + shared
npx wrangler dev                         # remote dev server
cd local && npm install && npm run build  # npm package

デプロイ

# Remote server
npx wrangler deploy

# npm + MCP Registry (recommended)
export MCP_PUBLISHER_KEY="your_saved_tickerdb_registry_private_key_hex"
./release.sh mcp patch

# npm only
cd local && npm version patch && npm run build && npm publish

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。