stockprice-mcp

# stockprice-mcp > **Status: Maintenance mode** — This project is stable and functional but not actively developed. Issues and PRs are welcome. Stock price & FX rate MCP server for Claude Desktop, powered by [yfinance](https://github.com/ranaroussi/yfinance). No API key required. > **Note**: An unrelated package named `yfinance-mcp` exists on PyPI — it is not affiliated with this project. > This project is published as **`stockprice-mcp`**. ## Setup (Claude Desktop) ```bash uvx stockprice-mcp serve ``` Add to `claude_desktop_config.json`: ```json { "mcpServers": { "stockprice": { "command": "uvx", "args": ["stockprice-mcp", "serve"] } } } ``` ## Tools | Tool | Description | |------|-------------| | `get_stock_price` | Latest price + fundamentals for TSE-listed stocks (code.T) | | `get_stock_history` | OHLCV history for a date range | | `get_fx_rates` | JPY FX rates (USDJPY, EURJPY, GBPJPY, CNYJPY) | | `search_ticker` | Search ticker by company name or keyword | ## Usage in Claude Desktop ```text stockprice でトヨタ（7203）の最新株価を教えて ``` ```text stockprice で USDJPY の直近1週間の推移を確認して ``` ```text stockprice でソニーのティッカーを検索して ``` ## CLI ```bash pip install stockprice-mcp yfinance-mcp price 7203 # 最新株価 yfinance-mcp history 7203 --start 2025-01-01 # 価格履歴 yfinance-mcp fx # FXレート yfinance-mcp search Toyota # ティッカー検索 yfinance-mcp test # 疎通確認 yfinance-mcp serve # MCPサーバー起動 ``` ## Python ```python import asyncio from yfinance_mcp import YfinanceClient async def main(): client = YfinanceClient() price = await client.get_stock_price("7203") print(price.close, price.trailing_pe) asyncio.run(main()) ``` ## Disclaimer This package uses [yfinance](https://github.com/ranaroussi/yfinance) (Apache 2.0). Data is intended for personal, educational, and research use. ## License Apache-2.0