Navigation
@qubaomingg/stock-mcp: Precision Query, Intelligent Analysis - MCP Implementation

@qubaomingg/stock-mcp: Precision Query, Intelligent Analysis

Master real-time stock insights with @qubaomingg/stock-mcp –精准查询、智能分析,助您决胜股市先机。

Research And Data
4.4(198 reviews)
297 saves
138 comments

Users create an average of 49 projects per month with this tool

About @qubaomingg/stock-mcp

What is @qubaomingg/stock-mcp: Precision Query, Intelligent Analysis?

This Model Context Protocol (MCP) server bridges stock market data from Alpha Vantage API to AI tools like Claude. It enables real-time and historical stock analysis by exposing standardized endpoints for data retrieval and alert generation. The solution is designed for developers integrating financial data into intelligent applications.

How to use @qubaomingg/stock-mcp: Precision Query, Intelligent Analysis?

Implementation involves three core steps:
1. Setup - Install dependencies and configure your Alpha Vantage API key via .env file
2. Integration - Deploy the server using npm commands and configure MCP clients like Claude for Desktop
3. Execution - Leverage built-in tools/resources for querying data or setting price movement alerts

@qubaomingg/stock-mcp Features

Key Features of @qubaomingg/stock-mcp: Precision Query, Intelligent Analysis?

  • Granular intraday data access with interval customization (1-60min)
  • Compact/full historical data options spanning up to 20 years
  • Automated price threshold alert system with configurable sensitivity
  • MCP resource URI scheme for seamless data referencing (e.g., stock://TSLA/15min)
  • TypeScript-based architecture with test-driven development support

Use cases of @qubaomingg/stock-mcp: Precision Query, Intelligent Analysis?

Common applications include:
• Real-time stock trend monitoring for algorithmic trading systems
• Historical pattern analysis via multi-year data comparison
• Automated alert workflows for portfolio risk management
• Contextual data injection into AI-driven market commentary generation

@qubaomingg/stock-mcp FAQ

FAQ from @qubaomingg/stock-mcp: Precision Query, Intelligent Analysis?

How do I obtain an API key? Visit Alpha Vantage's official portal and register for free access.
What if my server path isn't recognized? Verify the working directory when executing npm commands and ensure proper node_modules installation.
Can I customize alert thresholds? Yes, sensitivity parameters are configurable in the alert generation tool's API payload.
Does this support cryptocurrency data? Currently limited to equities - check Alpha Vantage's API documentation for additional data types.

Content

Alpha Vantage Stock MCP Server

This is a Model Context Protocol (MCP) server that provides stock market data from Alpha Vantage API. It allows Claude and other MCP clients to access real-time and historical stock data.

Features

  • Get intraday stock data with customizable intervals
  • Get daily stock data
  • Generate stock alerts based on price movements
  • Access stock data as resources

Prerequisites

  • Node.js 16 or higher
  • An Alpha Vantage API key (get one for free at Alpha Vantage)

Installation

  1. Clone this repository
  2. Install dependencies: npm install
  3. Create a .env file in the root directory and add your Alpha Vantage API key: ALPHA_VANTAGE_API_KEY=your_api_key_here

Building and Running

Build the TypeScript code: npm run build

Run the server: npm start

For development with auto-reloading: npm run dev

Test the API client: npm test

Using with Claude for Desktop

To use this MCP server with Claude for Desktop:

  1. Open Claude for Desktop
  2. Go to Settings > Developer > Edit Config
  3. Add the following to your claude_desktop_config.json:

json { "mcpServers": { "alpha-vantage": { "command": "node", "args": ["/absolute/path/to/dist/index.js"], "env": { "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY" } } } }

Replace /absolute/path/to/dist/index.js with the absolute path to the built index.js file.

  1. Restart Claude for Desktop

Available Tools

get-stock-data

Gets intraday stock data for a specific symbol.

Parameters:

  • symbol (required): Stock symbol (e.g., IBM, AAPL)
  • interval (optional): Time interval between data points (1min, 5min, 15min, 30min, 60min). Default: 5min
  • outputsize (optional): Amount of data to return (compact: latest 100 data points, full: up to 20 years of data). Default: compact

get-daily-stock-data

Gets daily stock data for a specific symbol.

Parameters:

  • symbol (required): Stock symbol (e.g., IBM, AAPL)
  • outputsize (optional): Amount of data to return (compact: latest 100 data points, full: up to 20 years of data). Default: compact

get-stock-alerts

Analyzes stock data to generate alerts based on price movements.

Parameters:

  • symbol (required): Stock symbol (e.g., IBM, AAPL)
  • threshold (optional): Percentage threshold for price movement alerts. Default: 5

Available Resources

stock-data

Access stock data directly as a resource.

URI Template: stock://{symbol}/{interval}

Parameters:

  • symbol: Stock symbol (e.g., IBM, AAPL)
  • interval: Time interval (daily, 1min, 5min, 15min, 30min, 60min). Default: daily

Example usage in Claude:

  • "Can you analyze this stock data: stock://AAPL/daily"
  • "What do you think about this data: stock://MSFT/5min"

License

ISC

Related MCP Servers & Clients