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. 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)

uvx stockprice-mcp serve

Add to claude_desktop_config.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

stockprice でトヨタ（7203）の最新株価を教えて

stockprice で USDJPY の直近1週間の推移を確認して

stockprice でソニーのティッカーを検索して

CLI

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

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 (Apache 2.0). Data is intended for personal, educational, and research use.

License

Apache-2.0