A Simple MCP Server

🚀 株価MCPサーバー

このサーバーは、yfinanceライブラリを用いて株価情報を提供するシンプルなモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このMCPサーバーは、株価の取得と比較を行うツールを提供します。機能豊富なMCPサーバーの構築方法を示し、以下のような様々な機能を備えています。

• 現在の株価を取得する
• 過去の株価データを取得する
• 異なる株の価格を比較する
• リソースインターフェイスを通じて株価データを公開する（形式: stock://{symbol}）

✨ 主な機能

株価検索

有効な任意の株価コードの最新株価を取得できます。このサーバーは、市場が閉じている場合や無効なコードの場合も適切に処理します。

過去データのアクセス

様々な期間の過去の株価データをCSV形式で取得できます（デフォルトは1ヶ月ですが、カスタマイズ可能）。

株の比較

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（モデルコンテキストプロトコル）
• yfinance
• FastAPI
• Uvicorn

📄 ライセンス

MIT License