💹 MCP YFinance Stock Server

Name: 💹 MCP YFinance Stock Server
Author: Adity-star

@Adity-star

代码仓库主页

关于 💹 MCP YFinance Stock Server

Real-time stock API with Python, MCP server example, yfinance stock analysis dashboard

#python #fastapi #yfinance #mcp-server

基本信息

分类

金融与商务

许可证

MIT

运行时

python

传输方式

stdio

发布者

Adity-star

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-yfinance-server": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP YFinance Stock Server?

MCP YFinance Stock Server is a stock price server powered by the Yahoo Finance (YFinance) API and built for integration with the Model Context Protocol (MCP). It allows AI agents or clients to retrieve real-time stock data, manage a watchlist, perform full stock analysis, and run technical indicators.

How to use MCP YFinance Stock Server?

Set up the environment using uv, install the project with uv pip install -e ., and start the server with uv run main.py. Configure the server by adding an entry to your mcp.config.json file pointing to the project directory and main script. For testing, use python run test_server_fun.py or inspect with mcp dev source/yf_server.py.

Key features of MCP YFinance Stock Server

Retrieve real-time stock prices
Manage a personal watchlist (add, view prices)
Perform 1-month technical trend analysis (RSI, MACD, MAs)
Generate comprehensive technical summaries with indicators
Analyze trend shifts, patterns, and divergences
Compare stock prices for relative performance analysis

Use cases of MCP YFinance Stock Server

Dynamic watchlist management
Trend and momentum detection
Deep-dive technical analysis for investment decisions
Volatility-based risk assessment
Powering stock-focused autonomous agents or dashboards

FAQ from MCP YFinance Stock Server

What are the dependencies or runtime requirements?

The server requires Python 3.10 and uses the uv package manager. Dependencies are defined in pyproject.toml and installed via uv pip install -e ..

How do I configure the server for Claude Desktop?

Add an entry to your mcp.config.json with the command uv, arguments ["--directory", "/ABSOLUTE/PATH/TO/YOUR/mcp-yfinance-server", "run", "main.py"], and then restart Claude Desktop.

How many tools does the server expose?

The server exposes 18 tools, including add_to_watchlist, analyze_stock, get_technical_summary, get_watchlist_prices, get_trend_analysis, get_stock_price, get_volatility_analysis, and compare_stocks.

What data source does the server use?

It uses the Yahoo Finance (YFinance) API to fetch stock data. No other data sources are mentioned.

Is the server free and open source?

Yes, the project is licensed under MIT and uses the publicly available Yahoo Finance API. Contributions and forks are welcome.

金融与商务分类下的更多 MCP 服务器

Octagon: MCP for Market Data

OctagonAI

An MCP server for public & prediction markets research. Ask natural-language questions and get structured, source-backed answers across SEC filings, earnings transcripts, company financials, stock & crypto market data, and prediction markets news & research. Built for investors,

142