Stock Price MCP Server

株価 MCP サーバー

yfinance ライブラリを使用して株価情報を提供する、シンプルな Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、株価を取得して比較するためのツールを提供します。複数の機能を備えた実用的な MCP サーバーの構築方法を紹介します。

• 現在の株価を取得
• 過去の株価データを取得
• さまざまな株式の株価を比較
• 株価データをリソースとして公開

機能

株価の取得

有効なティッカーシンボルの最新株価を取得します。市場の休場や無効なシンボルにも適切に対処します。

過去データへのアクセス

期間を指定して（デフォルトは1か月、変更可能）過去の株価データを CSV 形式で取得します。

株価の比較

異なる2つの株式の株価を、人が読みやすい形式で比較します。

リソースの公開

stock://{symbol} というパターンを使用したリソースベースのインターフェースから株式情報にアクセスできます。

インストール

1. このリポジトリをクローンします
2. 必要な依存関係をインストールします。

   pip install -r requirements.txt
   

使い方

サーバーの起動

次のコマンドでサーバーを起動します。

python stock_price_server.py

利用可能なツール

このサーバーは次のツールを提供します。

1. get_stock_price(symbol)：株式の現在の株価を浮動小数点数で返します
2. get_stock_history(symbol, period)：過去の株価データを CSV 形式で返します
3. compare_stocks(symbol1, symbol2)：2つの株式の株価を比較します

リソースの使用

stock://{symbol} というパターンでリソースにアクセスすると、書式設定された株価情報が返されます。

エラー処理

すべての関数に堅牢なエラー処理が含まれており、データの取得に失敗した場合は、内容がわかるエラーメッセージを返します。

• 無効なシンボルには適切なエラーメッセージを返します
• ネットワークの問題を適切に処理します
• 市場の休場時には代替の株価情報で対応します

要件

• Python 3.7+
• mcp-server（Model Context Protocol）
• yfinance
• FastAPI
• Uvicorn

ライセンス

MIT ライセンス