Financial Analysis MCP Server

金融分析 MCP サーバー

株価データの取得や可視化機能を提供する、強力な金融分析サーバーです。

機能

• yfinance からの株価データ取得
• Alpha Vantage API との連携
• 金融情報のウェブ検索
• Plotly によるインタラクティブな可視化
• RESTful API エンドポイント

前提条件

• Python 3.8+
• Alpha Vantage API キー（追加データを利用する場合）

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd fin-mcp

2. 仮想環境を作成して有効化します：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 依存関係をインストールします：

pip install -r requirements.txt

4. ルートディレクトリに .env ファイルを作成し、Alpha Vantage API キーを追加します：

ALPHA_VANTAGE_API_KEY=your_api_key_here

使用方法

1. サーバーを起動します：

cd src
python main.py

2. サーバーは http://localhost:8000 で起動します。

3. API ドキュメントは http://localhost:8000/docs で確認できます。

API エンドポイント

株価データ

• GET /api/v1/stock/{symbol} - yfinance から株価データを取得します
• GET /api/v1/alpha-vantage/{symbol} - Alpha Vantage から株価データを取得します
• GET /api/v1/search/{query} - 金融情報を検索します

可視化

• GET /api/v1/visualize/candlestick/{symbol} - ローソク足チャートを取得します
• GET /api/v1/visualize/volume/{symbol} - 出来高チャートを取得します
• GET /api/v1/visualize/combined/{symbol} - 株価と出来高を組み合わせたチャートを取得します

使用例

import requests

# Get stock data
response = requests.get("http://localhost:8000/api/v1/stock/AAPL")
data = response.json()

# Get candlestick chart
response = requests.get("http://localhost:8000/api/v1/visualize/candlestick/AAPL")
chart_data = response.json()

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。