Stock Market MCP Server

Name: Stock Market MCP Server
Author: sverze

@sverze

リポジトリ

Stock Market MCP Server について

A Machine Conversation Protocol (MCP) server that provides stock market data and analysis tools using the Finnhub API.

基本情報

カテゴリ

金融とコマース

ランタイム

python

トランスポート

stdio

公開者

sverze

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "stock-market-mcp-server-sverze": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

Search for stock symbols by company name

Get the latest price for a stock

Get key financial metrics for a company

Get the latest market news by category

Get news for a specific company over a date range

Get historical price data for a stock

概要

What is Stock Market MCP Server?

A Machine Conversation Protocol (MCP) server that provides stock market data and analysis tools using the Finnhub API. It offers stock symbol lookup, real-time prices, financial metrics, market and company news, and historical price data, along with pre-built prompts for common analysis tasks.

How to use Stock Market MCP Server?

Prerequisites include Python 3.8+, uv (fast Python package installer), a free Finnhub API key, and optionally Claude Desktop. Set up by cloning the repository, creating a virtual environment with uv, installing dependencies, and adding your FINNHUB_API_KEY to a .env.local file. Run the server with uv run stock-market-server.py and configure it as a local MCP tool in Claude Desktop or use the included stock market client with an Anthropic API key.

Key features of Stock Market MCP Server

Stock symbol lookup by company name
Real-time stock price retrieval
Basic financial metrics for a company
Market news by category and company-specific news
Historical price data (candles)
Pre-built prompts for stock analysis, market overview, and news analysis

Use cases of Stock Market MCP Server

Looking up stock symbols and current prices on demand
Analyzing a stock as a potential investment using pre-built prompts
Getting a comprehensive market overview with latest news and prices
Examining historical price movements and company news impact

FAQ from Stock Market MCP Server

What are the prerequisites to use this server?

Python 3.8 or higher, uv (pip install uv), a free Finnhub API key, and optionally Claude Desktop for integration.

How do I get a Finnhub API key?

How do I run the server?

After setup, execute uv run stock-market-server.py from the project directory. The server runs in stdio mode by default.

Can I use the server without Claude Desktop?

Yes, you can also use the included stock market client by setting an Anthropic API key in a .env file and running uv run stock_market_client.py.

What authentication is required?

Authentication uses a Finnhub API key stored in a .env.local file as FINNHUB_API_KEY=your_api_key_here. No other authentication is needed.

「金融とコマース」の他のコンテンツ

Crypto Sentiment MCP Server

kukapay

An MCP server that delivers cryptocurrency sentiment analysis to AI agents.

Binance MCP Server 🚀

AnalyticAce

Unofficial tools and server implementation for Binance's Model Context Protocol (MCP). Designed to support developers building crypto trading AI Agents.