Stock Price MCP Server

🚀 株価MCPサーバー

FastMCPベースの株価クエリサーバーで、リアルタイムの株式市場データを提供します。

✨ 主な機能

yfinanceを使用してリアルタイムの株式データを取得します。

• get_stock_price(symbol: str) - リアルタイムの株価と関連情報を取得します。

  • 米国株式（AAPL、GOOGL、TSLA、MSFTなど）をサポートします。
  • 台湾株式（2330.TW、2317.TWなど）をサポートします。
  • 価格、変動、出来高、時価総額などを返します。

• get_stock_history(symbol: str, period: str) - 過去の価格を取得します。

  • 期間オプション: 1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max
  • OHLCV（始値、高値、安値、終値、出来高）データを返します。

• get_stock_info(symbol: str) - 詳細な株式情報を取得します。

  • 会社名、業種、国
  • 従業員数、時価総額、PER
  • 52週間の高値/安値など

• greet(name: str) - 挨拶ツール

🚀 クイックスタート

📦 FastMCPクラウドへのクイックデプロイ

ステップ1: このリポジトリをフォークまたはクローンする

git clone https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
cd stock-price-mcp-server

ステップ2: 自分のGitHubにプッシュする

git remote set-url origin https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
git push -u origin main

ステップ3: FastMCPクラウドにデプロイする

1. FastMCPクラウドにアクセスします。
2. GitHubアカウントでサインインします。
3. 「新しいプロジェクトを作成」をクリックします。
4. プロジェクト情報を入力します。
   • 名前: stock-price-server（または好きな名前）
   • GitHubリポジトリ: 自分のリポジトリを選択します。
   • エントリーポイント: server.py:mcp
   • 認証: パブリックまたは組織限定を選択します。
5. 「デプロイ」をクリックします。

ステップ4: サーバーを使用する

デプロイ後、サーバーは以下のURLで利用可能になります。

https://your-project-name.fastmcp.app/mcp

Claude Desktop、Cursor、または他のMCPクライアントでこのサーバーに接続できます。

💻 ローカル開発

必要条件

• Python 3.10以上
• uv（推奨）またはpip
• FastMCP CLI

依存関係のインストール

uvを使用する場合:

uv pip install -r requirements.txt

ローカルでサーバーを実行する

FastMCP開発サーバーを起動します。

fastmcp dev server.py:mcp

サーバーはhttp://localhost:8000で利用可能になります。

注意: uv run server.pyを使用しないでください。FastMCPサーバーはfastmcp CLIツールを通じて実行する必要があります。

サーバー構成の検証

サーバーを実行せずに検査するには:

fastmcp inspect server.py:mcp

サーバーのテスト

サーバーを起動した後、別のターミナルでテストクライアントを使用してテストできます。

uv run main.py

📈 サポートされる株式シンボル

米国株式

• AAPL - Apple Inc.
• GOOGL - Alphabet Inc.
• TSLA - Tesla Inc.
• MSFT - Microsoft Corporation
• NVDA - NVIDIA Corporation
• META - Meta Platforms Inc.

台湾株式

• 2330.TW - 台湾積体電路製造
• 2317.TW - 鴻海精密工業
• 2454.TW - 聯發科技
• 2412.TW - 中華電信

その他の市場

• 9988.HK - アリババ（香港）
• 600519.SS - 貴州茅臺（上海）

💻 使用例

Claude Desktopでの使用

1. Claude Desktopの設定を開きます。
2. MCPサーバーを追加します。

{
  "mcpServers": {
    "stock-price": {
      "url": "https://your-project-name.fastmcp.app/mcp"
    }
  }
}

3. Claude Desktopを再起動します。
4. 「AAPLの株価はいくらですか？」または「TSMCの先月の価格トレンドを教えて」などの質問をすることができます。

FastMCPクライアントの使用

import asyncio
from fastmcp import Client

async def query_stock():
    client = Client("https://your-project-name.fastmcp.app/mcp")
    async with client:
        # リアルタイムの株価をクエリする
        result = await client.call_tool("get_stock_price", {"symbol": "AAPL"})
        print(result.data)

        # 過去の価格をクエリする
        history = await client.call_tool("get_stock_history", {
            "symbol": "TSLA",
            "period": "1mo"
        })
        print(history.data)

asyncio.run(query_stock())

🔧 技術詳細

• データソース: Yahoo Finance（yfinanceパッケージ経由）
• 更新頻度: リアルタイム（Yahoo Finance APIの制限により15分遅延）
• サポートされる市場: 主要な世界の株式市場（米国、台湾、香港、中国など）
• デプロイメントプラットフォーム: FastMCPクラウド
• 自動デプロイ: メインブランチへのプッシュ時に自動的に再デプロイされます。
• PRプレビュー: 各PRには一意のテストURLが割り当てられます。

📂 ファイル構造

stock-price-mcp-server/
├── server.py           # FastMCPサーバーの実装
├── requirements.txt    # Pythonの依存関係
├── pyproject.toml      # プロジェクトの設定
├── .gitignore         # Gitの無視ルール
└── README.md          # ドキュメント

📄 ライセンス

MITライセンス

🤝 コントリビューション

イシューとプルリクエストを歓迎します！

🆘 サポート

質問がある場合は:

1. FastMCP公式ドキュメントを確認します。
2. GitHubイシューを提出します。
3. FastMCPクラウドでヘルプを求めます。