MCP.so

๐Ÿ“ˆ Finance MCP Server

@akshatbindal

๐Ÿ“ˆ Finance MCP Server ใซใคใ„ใฆ

ๆฆ‚่ฆใฏใพใ ใ‚ใ‚Šใพใ›ใ‚“

ๅŸบๆœฌๆƒ…ๅ ฑ

ใ‚ซใƒ†ใ‚ดใƒช

้‡‘่žใจใ‚ณใƒžใƒผใ‚น

ใƒฉใ‚คใ‚ปใƒณใ‚น

Apache-2.0 license

ใƒฉใƒณใ‚ฟใ‚คใƒ 

python

ใƒˆใƒฉใƒณใ‚นใƒใƒผใƒˆ

stdio

ๅ…ฌ้–‹่€…

akshatbindal

่จญๅฎš

ไปฅไธ‹ใฎ่จญๅฎšใ‚’ไฝฟใฃใฆใ€ใ“ใฎใ‚ตใƒผใƒใƒผใ‚’ MCP ๅฏพๅฟœใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใซ่ฟฝๅŠ ใ—ใฆใใ ใ•ใ„ใ€‚

{
  "mcpServers": {
    "finance-mcp-server-akshatbindal": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

ใƒ„ใƒผใƒซ

ใƒ„ใƒผใƒซใฏๆคœๅ‡บใ•ใ‚Œใพใ›ใ‚“ใงใ—ใŸ

ใƒ„ใƒผใƒซใฏ README ใ‹ใ‚‰่‡ชๅ‹•็š„ใซๆŠฝๅ‡บใ•ใ‚Œใพใ™ใ€‚ใƒกใƒณใƒ†ใƒŠใƒผใฏ ## Tools ใจใ„ใ†่ฆ‹ๅ‡บใ—ใฎไธ‹ใซ่จ˜่ผ‰ใ™ใ‚‹ใ“ใจใงใ€ใ“ใฎใ‚ฟใƒ–ใซๅๆ˜ ใงใใพใ™ใ€‚

ๆฆ‚่ฆ

What is ๐Ÿ“ˆ Finance MCP Server?

A Model Context Protocol (MCP) server that brings comprehensive stock market data and technical analysis capabilities to MCP-compatible clients such as Claude Desktop. It provides real-time quotes, historical data, professional-grade indicators, and company fundamentals via the Yahoo Finance API.

How to use ๐Ÿ“ˆ Finance MCP Server?

Install the package with pip install finance-mcp-server and add a JSON configuration entry under mcpServers in Claude Desktop. Once configured, ask natural language questions like โ€œWhatโ€™s Appleโ€™s current stock price and market cap?โ€ or โ€œCalculate RSI for Microsoft.โ€ The server exposes eleven MCP tools covering everything from stock info to sector performance.

Key features of ๐Ÿ“ˆ Finance MCP Server

  • Complete stock profiles and market metrics
  • Customizable historical price data (multiple timeframes)
  • Live stock prices with change calculations
  • 10+ professional technical analysis indicators
  • Intelligent caching for optimal performance
  • Robust error handling and validation

Use cases of ๐Ÿ“ˆ Finance MCP Server

  • Get current stock price, market cap, and key statistics
  • Analyze historical performance over weeks or months
  • Compute RSI, MACD, Bollinger Bands, and moving averages
  • Compare moving averages across multiple stocks
  • Retrieve earnings calendar, options chain, and analyst recommendations

FAQ from ๐Ÿ“ˆ Finance MCP Server

What data source does the server use?

All data is retrieved in real-time from Yahoo Finance; no user data is stored or tracked.

What are the runtime requirements?

Python 3.8 or higher, with dependencies: mcp >= 1.0.0, yfinance >= 0.2.18, pandas >= 2.0.0, and ta >= 0.10.2.

How is caching handled?

Company info, news, options, holders, and recommendations are cached for 5โ€“60 minutes. Real-time data caches for 1 minute. Fundamentals cache for 10 minutes.

What transport and authentication are used?

The server uses the MCP protocolโ€™s standard stdio transport. No authentication is required; data is fetched from public Yahoo Finance endpoints.

How can I report issues or contribute?

Report bugs or request features via the GitHub Issues page. Contributions are welcome โ€“ fork the repo, create a feature branch, run tests (pytest), and submit a pull request.

ใ‚ณใƒกใƒณใƒˆ

ใ€Œ้‡‘่žใจใ‚ณใƒžใƒผใ‚นใ€ใฎไป–ใฎใ‚ณใƒณใƒ†ใƒณใƒ„