fintools-mcp

MCP (Model Context Protocol) を介したAIアシスタント向けの金融分析ツール。

Claude、ChatGPT、Cursor、またはMCP互換のAIに、単なる株価だけでなく、トレーダーが実際に使用する分析ツールキットへのアクセスを提供します。

ツール

ツール	機能
`get_technical_indicators`	RSI、MACD、ATR、EMA (9/21/50/200)、フィボナッチレベル、トレンド評価
`get_stock_quote`	現在価格、出来高、52週レンジ、時価総額
`get_trend_score`	-100（強い下降トレンド）から+100（強い上昇トレンド）までのトレンドスコアと構成要素の内訳
`get_support_resistance`	タッチ回数と強度評価を含む主要なサポート/レジスタンスレベル
`screen_stocks`	RSI、トレンドスコア、EMA位置、相対出来高によるS&P 500のスクリーニング — セットアップを迅速に発見
`analyze_options_chain`	IV分析、流動性フィルタリング、プット/コール比率を含むオプションチェーン
`calculate_position_size`	ストップロスと利益目標を用いたリスクベースのポジションサイジング
`calculate_atr_position`	ATRベースのポジションサイジング — ボラティリティからストップとターゲットを自動計算
`analyze_trades`	取引損益からの勝率、プロフィットファクター、シャープレシオ、ドローダウン、連勝/連敗記録
`compare_tickers`	複数のシンボル間でのテクニカル比較

仕組み

fintools-mcp シーケンス図

クイックスタート

インストール

pip install fintools-mcp

または uv を使用する場合:

uv pip install fintools-mcp

Claude Desktopへの追加

~/Library/Application Support/Claude/claude_desktop_config.json を編集します:

{
  "mcpServers": {
    "fintools": {
      "command": "uv",
      "args": ["run", "--from", "fintools-mcp", "fintools-mcp"]
    }
  }
}

pip経由でインストールした場合:

{
  "mcpServers": {
    "fintools": {
      "command": "fintools-mcp"
    }
  }
}

Claude Codeへの追加

claude mcp add fintools -- uv run --from fintools-mcp fintools-mcp

使用例

設定が完了すると、AIアシスタントに以下のような質問ができます:

「200 EMAより上で、売られすぎているS&P 500銘柄を探して」
「SPYのトレンドスコアは？」
「NVDAのサポートとレジスタンスレベルを表示して」
「AAPLの現在のテクニカルセットアップはどうなっている？」
「来週金曜日のSPYオプションチェーンを分析して」
「10万ドルの口座で1.5%のリスクを取ってNVDAをロングする場合、何株購入すべきで、ストップはどこに置くべき？」
「AAPL、GOOGL、MSFT、AMZNを比較して、最も強いトレンドはどれ？」
「私の過去20回の取引結果はこれです: [150, -80, 200, ...] — 勝率とシャープレシオは？」

出力例

テクニカル指標

> "What's the technical setup on SPY?"

SPY @ $573.42
  RSI(14): 58.3 — bullish momentum
  MACD: 2.14 (histogram +0.38, bullish)
  ATR(14): $7.82
  EMAs: 9 > 21 > 50 > 200 (fully stacked bullish)
  Fibonacci: In golden pocket (0.618-0.65 retracement)
  Trend: Bullish (all signals aligned)

ポジションサイジング

> "Size a long position on AAPL at $227, stop $220, target $245"

  Shares: 214
  Position value: $48,578
  Risk: $1,498 (1.5% of $100k)
  Reward: $3,852
  R:R ratio: 2.57

アーキテクチャ

fintools-mcp/
├── fintools_mcp/
│   ├── server.py              # MCP server — tool definitions
│   ├── data.py                # Market data via yfinance
│   ├── indicators/            # Technical indicators (standalone, no deps)
│   │   ├── rsi.py             # RSI — Wilder's smoothing
│   │   ├── macd.py            # MACD (12, 26, 9)
│   │   ├── atr.py             # ATR — Average True Range
│   │   ├── ema.py             # EMA — any period
│   │   ├── vwap.py            # VWAP — intraday, daily reset
│   │   └── fibonacci.py       # Fibonacci retracement + golden pocket
│   └── analysis/
│       ├── position_sizer.py  # Risk-based + ATR-based sizing
│       └── trade_stats.py     # KPI calculator (60+ metrics)
└── tests/

データソース

株価データ: Yahoo Finance (無料、APIキー不要)
オプションデータ: Yahoo Finance オプションチェーン
基本機能にAPIキーは不要です。

開発

git clone https://github.com/slimbiggins007/fintools-mcp.git
cd fintools-mcp
uv sync
uv run python -m fintools_mcp  # starts the MCP server

テストの実行:

uv run pytest

ライセンス

MIT

fintools-mcp

fintools-mcp

ツール

仕組み

クイックスタート

インストール

Claude Desktopへの追加

Claude Codeへの追加

使用例

出力例

テクニカル指標

ポジションサイジング

アーキテクチャ

データソース

開発

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API