Yfinance MCP Server

🚀 yfinance-mcp-server

非公式のMCPサーバーで、Yahoo Financeのデータにアクセスするためのメッセージ制御プロトコル（MCP）サーバーです。このサーバーは、yfinanceを通じて株式市場データを取得するためのシンプルなインターフェースを提供します。

🚀 クイックスタート

このサーバーは、yfinanceを通じて株式市場データを取得するためのシンプルなインターフェースを提供します。以下に使用方法や機能などを説明します。

✨ 主な機能

• 指定したシンボルの過去の株式データを取得し、カスタムの期間と間隔をサポートします。
• 任意のMCPクライアントで簡単に使用できます。
• TypeScriptで構築されており、型安全と良好な開発体験を提供します。

💻 使用例

基本的な使用法

Cursor MCPクライアントの例です。

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": [
        "@onori/yfinance-mcp-server"
      ]
    }
  }
}

getStockHistory

指定したシンボルの過去の株式データを取得します。

パラメータ：

• symbol（必須）：株式コード（例：“AAPL”はApple社を表します）
• period（必須）：データを取得する期間（例：“1d”、“5d”、“1mo”、“3mo”、“6mo”、“1y”、“2y”、“5y”、“10y”、“ytd”、“max”）
• interval（オプション）：データ間隔（“1d”、“1wk”、“1mo”）

MCPリクエストの例

> (リクエスト) 
`getStockHistory`ツールを使用して、AAPLの過去1週間（`period`='1w'、`interval`='1d'）の毎日の株式データを取得してください。そして、結果をMarkdownテーブルとしてレンダリングしてください。

> (応答例)
私はあなたがApple社の株式データを取得し、それをより読みやすいMarkdownテーブルに整形するのを手伝います。
まず、私はgetStockHistoryツールを呼び出してデータを取得します。

このデータをより読みやすいMarkdownテーブルに整形しましょう：

| 日付 | 始値 | 高値 | 安値 | 終値 | 出来高 |
|------|--------|--------|--------|--------|--------|
| 2025年3月31日 | $217.01 | $225.62 | $216.23 | $222.13 | 65.30M |
| 2025年4月1日 | $219.81 | $223.68 | $218.90 | $223.19 | 36.41M |
| 2025年4月2日 | $221.32 | $225.19 | $221.02 | $223.89 | 35.91M |
| 2025年4月3日 | $205.54 | $207.49 | $201.25 | $203.19 | 103.42M |
| 2025年4月4日 | $193.89 | $199.88 | $187.34 | $188.38 | 125.57M |

これらのデータから、以下のことがわかります：
- 株価はこの1週間で著しい変動を見せています。
- 最後の2日間で急激な下落が見られます。
- 下落期間中の出来高は大幅に増加しており、4月4日の出来高が最も高いです（125.57M株）。
- この期間の株価は最高$225.62から最低$187.34の範囲で推移しています。

これらのデータに対して特定の分析を行う必要がある場合や、異なる指標を見たい場合は、お知らせください。

📦 インストール

開発環境を設定するには、以下の手順に従ってください。

1. リポジトリをクローンします。
2. 依存関係をインストールします：

npm install

3. 開発サーバーを起動します：

npm run dev

🤝 貢献

貢献いただけることを歓迎します！Pull Requestをいつでも送信してください。

📄 ライセンス

ISCライセンス (ISC)

⚠️ 重要提示

これは非公式のMCPサーバーです。