https://github.com/onori/yfinance-mcp-server
Unofficial MCP server for Yahoo Finance stock data.
https://github.com/onori/yfinance-mcp-server
Last synced: 9 days ago
JSON representation
Unofficial MCP server for Yahoo Finance stock data.
- Host: GitHub
- URL: https://github.com/onori/yfinance-mcp-server
- Owner: onori
- Created: 2025-04-06T07:04:23.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-06T08:25:39.000Z (7 months ago)
- Last Synced: 2025-09-27T07:25:35.622Z (about 1 month ago)
- Language: JavaScript
- Size: 23.4 KB
- Stars: 2
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README-ja.md
Awesome Lists containing this project
- awesome-mcp-servers - **yfinance-mcp-server** - Unofficial MCP server for Yahoo Finance stock data. `javascript` `mcp` `server` `npm install onori/yfinance-mcp-server` (🌐 Web Development)
README
# yfinance-mcp-server
[English](./README.md)
**重要な注意: これは非公式のMCPサーバーです。**
Yahoo Financeのデータにアクセスするためのメッセージコントロールプロトコル（MCP）サーバーです。このサーバーは、yfinanceを通じて株式市場データを取得するためのシンプルなインターフェースを提供します。
## 機能
- カスタマイズ可能な期間と間隔で株式の履歴データを取得
- どのMCPクライアントでも簡単に使用可能
- TypeScriptで構築され、型の安全性と優れた開発者体験を提供
## 使用方法
Cursor MCPクライアントの例：
```json
{
"mcpServers": {
"yfinance": {
"command": "npx",
"args": [
"@onori/yfinance-mcp-server"
]
}
}
}
```
### getStockHistory
指定された銘柄の株価履歴データを取得します。
パラメータ：
- `symbol`（必須）：株式銘柄（例：Appleの場合は"AAPL"）
- `period`（必須）：データを取得する期間（"1d"、"5d"、"1mo"、"3mo"、"6mo"、"1y"、"2y"、"5y"、"10y"、"ytd"、"max"）
- `interval`（オプション）：データの間隔（"1d"、"1wk"、"1mo"）
MCPリクエストの例：
```markdown
> (Request)
yfinanceを利用し、7203.T（トヨタ）の1週間分の日足株価データを取得し、markdown tableで表示してください
> (Response Example)
直近1週間分のトヨタ自動車（7203.T）の株価データを表形式で表示します：
| 日付 | 始値 | 高値 | 安値 | 終値 | 出来高 |
|------|------|------|------|------|--------|
| 2025-03-31 | 2,630.5 | 2,647.0 | 2,583.5 | 2,616.0 | 43,466,800 |
| 2025-04-01 | 2,649.0 | 2,656.5 | 2,616.5 | 2,630.5 | 26,218,100 |
| 2025-04-02 | 2,630.5 | 2,661.0 | 2,594.5 | 2,656.0 | 27,800,600 |
| 2025-04-03 | 2,500.5 | 2,582.5 | 2,456.5 | 2,518.5 | 63,506,800 |
| 2025-04-04 | 2,440.0 | 2,453.0 | 2,337.5 | 2,407.5 | 61,167,400 |
この期間中、株価は下落傾向にあり、特に4月3日と4月4日に大きく下落しています。出来高も4月3日と4月4日に大幅に増加しており、市場の関心が高まっていたことがわかります。
```
## 開発
開発環境のセットアップ：
1. リポジトリをクローン
2. 依存関係をインストール：
```bash
npm install
```
3. 開発サーバーを起動：
```bash
npm run dev
```
## コントリビューション
コントリビューションを歓迎します！お気軽にプルリクエストを提出してください。
## ライセンス
ISC License (ISC)