Skip to main content
Glama
grahammccain

Chart Library

by grahammccain

Chart Library MCPサーバー

PyPI License: MIT Glama Score Tools

対応環境: Claude Desktop | Claude Code | ChatGPT | GitHub Copilot | Cursor | VS Code | 各種MCPクライアント

AIエージェントに「このチャートが前回このような形だった時、どう動いた?」と尋ねれば、過去の類似事例のコホートと、その後の値動きの分布に基づいた正確な回答が得られます。

2,500万件以上のパターン埋め込み。10年分の履歴。19,000銘柄以上。ツール呼び出しは1回だけ。

> "What does NVDA's chart on 2024-08-05 1h look like historically?"

NVDA · 2024-08-05 · 1h — cohort of 500 historical analogs
(485 with realized 5-day returns)

  Distribution at 5 days forward:
    median:        −1.3%
    p10 ·· p90:    −11.3% ·· +6.8%   (80% empirical band)
    win rate:      44%
    cohort_score:  0.31 (modest)

  Features that separated winners from losers:
    + credit_spread_state = tight
    + macro_state = bullish
    + pct_off_52w_low (further off)
    − vol_regime = low

  Summary: NVDA's 1-hour pattern on 2024-08-05 has 500 historical
  analogs. The cohort's 5-day distribution is bearish-leaning
  (median −1.3%, win rate 44%) — the historical record does NOT
  show this pattern typically resolving bullish. Conditioning on
  tight credit spreads and a bullish macro state would have
  separated the outperformers within the cohort.

これは予測ではなく、検索です。ハルシネーション(幻覚)による予測はありません。チェリーピッキングもありません。エージェントが引用できる客観的な記録のみを提供します。


クイックスタート

pip install chartlibrary-mcp

Claude Desktop (ワンクリックインストール)

chart-library-1.1.1.mcpb 拡張ファイル(.mcpb)をダウンロードし、Claude Desktopで開くと自動的にインストールされます。

Claude Code

claude mcp add chart-library -- chartlibrary-mcp

Claude Desktop (手動設定)

claude_desktop_config.json に以下を追加してください:

{
  "mcpServers": {
    "chart-library": {
      "command": "chartlibrary-mcp",
      "env": {
        "CHART_LIBRARY_API_KEY": "cl_your_key"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp.json または VS CodeのMCP設定に追加してください:

{
  "servers": {
    "chart-library": {
      "command": "chartlibrary-mcp",
      "env": {
        "CHART_LIBRARY_API_KEY": "cl_your_key"
      }
    }
  }
}

GitHub Copilot (VS Code)

プロジェクト内の .vscode/mcp.json に追加してください(このファイルはchart-libraryのリポジトリに既に含まれています):

{
  "servers": {
    "chart-library": {
      "command": "chartlibrary-mcp",
      "env": {
        "CHART_LIBRARY_API_KEY": "cl_your_key"
      }
    }
  }
}

プロジェクトを開くと、Copilot Chatが自動的にMCPサーバーを検出します。Copilot Chatで @mcp を使用してツールを呼び出してください。

ChatGPT (開発者モード)

ChatGPTはリモートHTTPエンドポイント経由でMCPサーバーに接続します。設定手順:

  1. 開発者モードを有効化: ChatGPTの 設定 > アプリ > 詳細設定 > 開発者モード に移動します(Pro、Plus、Business、Enterprise、またはEducationプランが必要です)

  2. コネクタを作成: 「設定」>「コネクタ」で「作成」をクリックし、以下を入力します:

    • 名前: Chart Library

    • 説明: 過去のチャートパターン検索エンジン — 19,000銘柄以上、10年分のデータ、2,500万件以上のパターン

    • URL: https://chartlibrary.io/mcp

    • 認証: 認証なし(APIキーを使用する場合はOAuth)

  3. 会話で使用: Plusメニューから「開発者モード」を選択し、Chart Libraryアプリを選んで「NVDAのチャートは過去どのような動きをしましたか?」のように質問してください。

注意: https://chartlibrary.io/mcp のリモートエンドポイントはStreamable HTTPトランスポートを使用しています。SSEフォールバックが必要な場合は https://chartlibrary.io/mcp/sse を使用してください。

リモートMCPエンドポイント

リモートHTTP接続をサポートするすべてのMCPクライアント向け:

https://chartlibrary.io/mcp

このエンドポイントはStreamable HTTPとSSEトランスポートの両方をサポートしており、ローカルインストールは不要です。

無料枠:1日200回まで、クレジットカード不要。 chartlibrary.io/developers でAPIキーを取得するか、キーなしで基本検索をご利用ください。


Related MCP server: TickerAPI

エージェントで何ができるか?

「TSLAのポジションについて心配すべきか?」

> get_exit_signal("TSLA")

  Signal: HOLD (confidence: 72%)
  Similar patterns that exited early: 3/10 would have avoided a drawdown
  Similar patterns that held: 7/10 gained an additional +2.1% over 5 days
  Recommendation: Pattern suggests continuation. No exit signal triggered.

「現在、どのセクターがローテーションしているか?」

> get_sector_rotation()

  Leaders (30-day relative strength):
    1. XLK  Technology     +4.2%
    2. XLY  Cons. Disc.    +3.1%
    3. XLC  Communication  +2.8%

  Laggards:
    9. XLU  Utilities      -1.4%
   10. XLP  Cons. Staples  -2.1%
   11. XLRE Real Estate    -3.3%

  Regime: Risk-On (growth > defensives)

「SPYが3%下落した場合、AMDはどうなるか?」

> run_scenario("AMD", spy_change=-3.0)

  When SPY fell ~3%, AMD historically:
    Median move:  -5.2%
    Best case:    +1.1%
    Worst case:  -11.4%
    Positive:     18% of the time

  AMD shows 1.7x beta to SPY downside moves.

8つの標準ツール

Chart Library 2.0では、22のレガシーツールを8つの構成可能なプリミティブに統合しました。cohort_id ハンドルを介してチェーン接続することで、kNNを再実行することなくサブ秒単位での絞り込みが可能です。

ツール

機能

search

エントリーポイント。ティッカーと日付から cohort_id + アンカー + n_matches を返します。ハンドルを cohortanalyze、または explain に渡してチェーン接続します。

cohort

コアプリミティブ。 チャートパターンの条件付き分布(p10/p25/p50/p75/p90 + キャリブレーション済みバンド + MAE/MFE + ヒット率 + 生存率)を、レジーム/セクター/流動性/イベントでフィルタリングして返します。1回の呼び出しで、従来の get_cohort_distributionrefine_cohort_with_filtersrun_scenarioget_regime_win_rates を置き換えます。

analyze

metric= 列挙型による分析指標:anomalyvolume_profilecrowdingcorrelation_shiftearnings_reactionpattern_degradationregime_accuracy

context

target= による状況データ:ティッカーメタデータ、市場レジーム + セクターローテーション、またはDBカバレッジ統計。

explain

style= 列挙型によるナラティブ + ランキング:filter_ranking(どのフィルターが分布を最も変化させるか)、prose(平易な英語の要約)、position_guidance(出口シグナル)、risk_ranking(シャープレシオ順の銘柄選択)。

portfolio

保有銘柄全体のポートフォリオレベルの条件付き分布。分布の加重平均を算出し、テールリスクへの寄与度をランク付けします。

anchor_fetch

2.0の新機能。 軽量な(シンボル、日付)メタデータ取得 — セクター、時価総額、時点ごとのレジーム。ティッカーのコンテキストのみが必要な場合にフルkNNを回避します。

report_feedback

エラー報告や改善提案。

これらのツールは、ハルシネーションによる「平均してこのパターンはX%のリターンがある」という主張を、実際の条件付きベースレートに置き換えます。詳細なループについては grounded-base-rates パターン を参照してください。

一般的なエージェントフロー

1. search("NVDA 2024-06-18")                          → cohort_id
2. cohort(cohort_id=..., filters={regime:{same_vix_bucket: true}})
                                                       → conditional distribution
3. explain(cohort_id=..., style="filter_ranking")     → which filter matters most
4. cohort(cohort_id=..., filters={...new filter...})  → refined distribution

レガシーツール(非推奨、呼び出し可能)

後方互換性のため、これら22のレガシーツール名はそのまま残されており、MCPアノテーションで deprecated とマークされています。これらは標準ツールに転送され、将来のメジャーリリースで削除される予定です。以下のマッピングに従って移行してください:

レガシー

代替

search_charts, search_batch, get_discover_picks

search

get_cohort_distribution, refine_cohort_with_filters, run_scenario, get_regime_win_rates, compare_to_peers

cohort

detect_anomaly, get_volume_profile, get_crowding, get_earnings_reaction, get_correlation_shift, get_pattern_degradation, get_regime_accuracy

analyze (metric=)

get_sector_rotation, get_status, get_market_context

context

get_pattern_summary, explain_cohort_filters, get_exit_signal, get_risk_adjusted_picks

explain (style=)

get_portfolio_health

portfolio

analyze_pattern, get_follow_through, check_ticker

search + cohort (+ オプションで explain)


仕組み

Chart Libraryは、膨大な過去のチャートパターンをインデックス化し、条件付き分布APIを通じて提供します。すべてのクエリはサンプルサイズ、パーセンタイル、キャリブレーション済みのフォワードリターンバンドを返します。ポイント予測は行いません。

エージェントが analyze_pattern("NVDA") を呼び出すと、サーバーは以下の処理を行います:

  1. NVDAの現在のチャート状態の表現を構築

  2. 過去の類似パターンを検索

  3. その後1、3、5、10日間で何が起きたかを調査

  4. 分布 + Claude Haikuによる平易な英語の要約を返す

結果:エージェントがハルシネーションや曖昧な表現をすることなく、「N件の類似した過去のパターンにおいて、5日間のリターンの中央値はX%でした(80%バンド [p10, p90])」といった、事実に基づいた引用可能なステートメントを提示できます。


APIキー

プラン

1日あたりの呼び出し数

価格

Sandbox

200

無料

Builder

5,000

$29/月

Scale

50,000

$99/月

chartlibrary.io/developers でキーを取得してください。

export CHART_LIBRARY_API_KEY=cl_your_key

リンク


Chart Libraryは情報提供のみを目的として過去のパターンデータを提供しています。投資助言ではありません。

Install Server
A
license - permissive license
C
quality
B
maintenance

Maintenance

Maintainers
2dResponse time
2wRelease cycle
2Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Financial intelligence for AI agents. 31 tools across 8 data sources — regime, derivatives, stablecoin flows, momentum, volatility, macro, DeFi, weather patterns, political cycles, seasonality. The context layer between your agent and a bad trade.
    31
    31
    9
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Agent-ready financial intelligence tools for AI agents. Two curated tools — get_stock_snapshot and get_company_metrics — that combine multiple data sources, derive signals (UNDERVALUED, STRONG, ACCELERATING), and pre-compute the math. One call, one agent-friendly response.
    3
    116
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides actionable financial intelligence tools for AI agents including insider buying signals, earnings IV plays, market pulse, stock analysis, and options strategies via free public data sources.
    6
    MIT

View all related MCP servers

Related MCP Connectors

  • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

  • The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.

  • US stocks, ETFs, crypto → compact brief: patterns, S/R, regime + base rates vs baseline. Not advice.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/grahammccain/chart-library-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server