Fin MCP

🚀 財務分析 MCP サーバー

強力な機能を備えた財務分析サーバーで、株式データの検索と可視化機能を提供します。

🚀 クイックスタート

この財務分析 MCP サーバーは、株式データの取得や可視化を容易に行うことができます。以下の手順に従ってサーバーをセットアップし、使用してください。

✨ 主な機能

• yfinance から株式データを取得します。
• Alpha Vantage API を統合しています。
• 財務情報のウェブ検索が可能です。
• Plotly を使用したインタラクティブな可視化機能を備えています。
• RESTful API エンドポイントを提供します。

📦 インストール

1. リポジトリをクローンする

git clone <repository-url>
cd fin-mcp

2. 仮想環境を作成し、アクティブにする

python -m venv venv
source venv/bin/activate  # Windows の場合は：venv\Scripts\activate

3. 依存関係をインストールする

pip install -r requirements.txt

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

ALPHA_VANTAGE_API_KEY=your_api_key_here

💻 使用例

基本的な使用法

import requests

# 株式データを取得する
response = requests.get("http://localhost:8000/api/v1/stock/AAPL")
data = response.json()

# ローソク足チャートを取得する
response = requests.get("http://localhost:8000/api/v1/visualize/candlestick/AAPL")
chart_data = response.json()

📚 ドキュメント

サーバーの起動

cd src
python main.py

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

API ドキュメントのアクセス

http://localhost:8000/docs から API ドキュメントを参照できます。

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} - 価格と出来高の組み合わせチャートを取得します。

📄 ライセンス

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