Finmcp Finance Mcp

Yahoo Finance MCP サーバー（Cloud）

AI アシスタント向けの本番環境対応（Cloud）金融データ基盤です。エンタープライズグレードの高い耐障害性、包括的なデータ品質検証、本番環境対応のモニタリングを備えています。

クラウドにデプロイする（Docker ベース）

FinMCP には Dockerfile が付属しており、完全に Docker ベースで構成されています。そのため、コンテナーをサポートする Railway、Render、Fly.io、DigitalOcean App Platform、VPS など、あらゆるプラットフォームで実行できます。

最も簡単な方法 — Railway（初心者におすすめ）：

1. railway.com で登録します（紹介リンク — 無料クレジットを獲得できます）。
2. New Project → Deploy from GitHub repo を選択し、https://github.com/Steve-sy/finmcp を貼り付けます。
3. Railway が Dockerfile を自動検出し、ビルドとデプロイを自動的に行います。
4. （任意）エンドポイントを保護するには、Railway の Variables タブに YF_MCP_API_KEY を追加します。
5. Settings → Networking → Generate Domain に移動し、公開 URL を取得します。
6. MCP エンドポイントは次の URL で利用できます：https://<your-app>.up.railway.app/mcp

その他のプラットフォーム（Render、Fly.io、VPS など）：

Docker コンテナーを実行できるプラットフォームであれば、どれでも利用できます。このリポジトリを指定し、起動コマンドを node dist/http.js に設定してください。サーバーは PORT 環境変数で指定されたポート（多くのプラットフォームが自動的に設定）でリッスンし、デフォルトは 3333 です。

任意：公開デプロイを YF_MCP_API_KEY で保護し、...?key=YOUR_SECRET を使って接続できます。

Claude Desktop との連携（Cloud）

Customize -> Connectors -> Add custom connector: Name: FinMCP Remote MCP Server URL: クラウドの HTTPS URL：https:///mcp

---

ローカルインストール

npm install -g @mustafa.ramx/finmcp

クイックスタート

サーバーを起動する

finmcp

Claude Desktop との連携（ローカル — npm）

claude_desktop_config.json に次の設定を追加します：

{
  "mcpServers": {
    "finmcp": {
      "command": "finmcp"
    }
  }
}

Claude Desktop との連携（ローカル — Docker）

Node.js のインストールではなく Docker を使う場合は、まずイメージをビルドします：

docker build -t finmcp .

次に、claude_desktop_config.json に次の設定を追加します：

{
  "mcpServers": {
    "finmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "finmcp", "node", "dist/index.js"]
    }
  }
}

注： ChatGPT Desktop の MCP サポート状況は異なる場合があります。カスタムコネクターの設定については、ドキュメントをご確認ください。

その他の AI ツール

Cursor AI / Cline AI：

{
  "mcpServers": {
    "finmcp": {
      "command": "finmcp"
    }
  }
}

特長

• 15 種類の金融データツール：株式、オプション、暗号資産、外国為替、企業情報、市場センチメント
• サーキットブレーカーパターン：API 障害から自動復旧
• 複数のレート制限戦略：トークンバケット＋適応型＋エンドポイントごとの制限
• データ品質スコアリング：完全性と整合性を検証
• 包括的なキャッシュ：キャッシュヒット率の高さ（70～90％）と、キャッシュ利用不可時のフォールバック
• ストリーミング HTTP トランスポート：ローカルで実行するか、クラウド（Docker/Railway）にデプロイして HTTPS でアクセス
• 任意の API キー認証：公開デプロイを YF_MCP_API_KEY で保護
• エンタープライズ向けテスト：ユニットテスト、統合テスト、E2E テスト、カオステスト

利用可能なツール

市場データ

• get_quote - 品質レポート付きのリアルタイム相場
• get_historical_prices - 日付範囲を指定した OHLCV データ
• get_historical_prices_multi - 複数銘柄の過去データを一括取得

企業情報

• get_quote_summary - 企業概要の包括的な情報
• get_balance_sheet - 資産、負債、資本
• get_income_statement - 売上高、費用、純利益
• get_cash_flow_statement - 営業、投資、財務活動によるキャッシュフロー
• get_earnings - 予想値付きの四半期決算
• get_analysis - アナリストの推奨と目標株価
• get_major_holders - 機関投資家およびインサイダーの保有状況

市場センチメント

• get_news - 関連度スコア付きの最新記事
• get_options - ギリシャ指標付きのオプションチェーン
• get_trending_symbols - 出来高指標付きの値動き上位銘柄
• screener - 12 項目以上の条件で株式を絞り込み

複数資産

• get_crypto_quote - 暗号資産の価格
• get_forex_quote - 通貨ペアの為替レート

ドキュメント

設定、使用例、アーキテクチャの詳細、ベストプラクティスを含む完全なドキュメントについては、以下をご覧ください。

GitHub で完全なドキュメントを見る

ドキュメントには以下が含まれます。

• ツールの完全なリファレンス
• 使用例付きのガイド
• 設定ガイド
• アーキテクチャの詳細
• データ検証のステータス

設定

config.json ファイルを作成します。

{
  "rateLimit": {
    "requestsPerMinute": 60,
    "requestsPerHour": 1500
  },
  "cache": {
    "ttlQuotes": 60000,
    "maxCacheSize": 1000
  },
  "circuitBreaker": {
    "failureThreshold": 5,
    "monitoringWindow": 60000,
    "successThreshold": 3
  }
}

設定オプションの詳細については、設定ガイドをご覧ください。

パフォーマンス

指標	値
相場照会	1 分あたり 60 リクエスト（設定可能）
バッチ操作	1 リクエストあたり最大 100 銘柄
キャッシュヒット率	頻繁にアクセスされる銘柄では 70～90%
コールドスタート時間	<500ms
テストカバレッジ	コアミドルウェアで 95% 以上

ライセンス

MIT

リンク

• GitHub リポジトリ
• npm パッケージ
• MCP プロトコル
• 問題を報告