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
- Clone this repository
- Install dependencies:
- Create a
.env
file in the root directory and add your Alpha Vantage API key:
Building and Running
Build the TypeScript code:
Run the server:
For development with auto-reloading:
Test the API client:
Using with Claude for Desktop
To use this MCP server with Claude for Desktop:
- Open Claude for Desktop
- Go to Settings > Developer > Edit Config
- Add the following to your
claude_desktop_config.json
:
Replace /absolute/path/to/dist/index.js
with the absolute path to the built index.js file.
- 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: 5minoutputsize
(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
MIT
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Claude와 다른 MCP 클라이언트가 Alpha Vantage API의 실시간 및 과거 주식 시장 데이터에 액세스할 수 있도록 하며, 여기에는 사용자 정의 가능한 간격으로 일중 및 일간 주식 데이터가 포함됩니다.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.Last updated 4 months ago564PythonMIT License
- -securityFlicense-quality一个 Alpha Vantage API 查询 股票信息的 MCP server.Last updated 5 months ago4TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol tool that retrieves daily stock market data for any stock symbol using the Alpha Vantage API.Last updated 5 months ago721TypeScriptApache 2.0
- -securityAlicense-qualityAn MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.Last updated 3 months agoPythonMIT License