SaintDoresh/YFinance-Trader-MCP-ClaudeDesktop logo

SaintDoresh/YFinance-Trader-MCP-ClaudeDesktop

Free

使用 Yahoo Finance API 提供股市数据和分析的 MCP 工具。

FreeFree tier
Type
Open Source

About SaintDoresh/YFinance-Trader-MCP-ClaudeDesktop

YFinance Trader MCP Tool is an open-source, Python-based Model Context Protocol (MCP) tool that provides real-time stock market data and trading capabilities using the yfinance library, specifically adapted for Claude Desktop. It offers a range of financial data endpoints including real-time stock quotes, company information and key metrics, historical daily price data, symbol search, analyst recommendations, and insider transaction tracking. The tool is designed for seamless integration with Claude Desktop via MCP configuration, allowing users to query stock data through natural language. It is inspired by the mcp-stocks project and includes a step-by-step setup tutorial on Medium.

Key Features

Real-time stock quotes with price, change, volume, and timestamp
Company overview with name, sector, market cap, PE ratio, and 52-week high/low
Historical daily price data including open, high, low, close, and volume
Symbol search functionality for stocks and other securities
Analyst recommendations with strong buy, buy, hold, sell, and strong sell counts
Insider transaction tracking with details on insider, position, transaction type, and value

Pros & Cons

Pros
  • Provides comprehensive financial data from Yahoo Finance through a single MCP interface
  • Easy to set up with Claude Desktop by adding MCP server configuration
  • Open source and completely free to use with no API key required
  • Includes a detailed tutorial on Medium for setup and usage
  • Covers multiple data types: quotes, company info, history, recommendations, and insider trades
Cons
  • Requires manual configuration in Claude Desktop's MCP settings
  • Data source relies on Yahoo Finance, which may have occasional delays or limitations
  • No built-in trading execution; tool only retrieves data
  • Requires Python 3.10 or higher and manual dependency installation
  • Limited to stocks and securities available on Yahoo Finance

Best For

Get current stock price and trading volume for any symbolRetrieve company financial metrics and overview for investment researchFetch historical price data for technical analysis or backtestingSearch for stock tickers by company name or keywordObtain analyst consensus recommendations for a stockMonitor insider buying and selling activityIntegrate automated stock data queries into Claude Desktop workflows

FAQ

What are the system requirements for using this tool?
You need Python 3.10 or higher installed, and you must install the dependencies using 'pip install -r requirements.txt'.
How do I integrate this tool with Claude Desktop?
Add the MCP server configuration to your Claude Desktop settings file as shown in the README. The configuration specifies the Python command and the path to the main.py file.
What financial data can I retrieve with this tool?
You can get real-time stock quotes, company overview with key metrics, historical daily price data, symbol search results, analyst recommendations, and insider transactions.
Is this tool free to use?
Yes, the tool is open source and free. It uses the yfinance library which accesses public Yahoo Finance data without requiring an API key.
Can I use this tool for trading?
The tool provides data and analysis capabilities but does not execute trades. It is designed for research and information gathering within Claude Desktop.