What is Stock Analysis MCP?
Stock Analysis MCP is a Model Context Protocol (MCP) server that provides real-time and historical stock market data using the Alpha Vantage API.
How to use Stock Analysis MCP?
To use Stock Analysis MCP, clone the repository, install the dependencies, set up your Alpha Vantage API key in a .env file, and run the server. You can then access stock data through various endpoints.
Key features of Stock Analysis MCP?
- Retrieve intraday stock data with customizable intervals.
- Access daily stock data.
- Generate alerts based on stock price movements.
- Direct access to stock data as resources.
Use cases of Stock Analysis MCP?
- Analyzing stock performance over different time intervals.
- Setting up alerts for significant price changes in stocks.
- Integrating with other applications for real-time stock data.
FAQ from Stock Analysis MCP?
- What is required to run Stock Analysis MCP?
You need Node.js 16 or higher and an Alpha Vantage API key.
- How do I get an Alpha Vantage API key?
You can obtain a free API key from the Alpha Vantage website.
- Can I use this with other applications?
Yes, it can be integrated with applications like Claude for Desktop.
# 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](https://www.alphavantage.co/support/#api-key))
Installation
- Clone this repository
- Install dependencies: ``` npm install ```
- 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:
- Open Claude for Desktop
- Go to Settings > Developer > Edit Config
- 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.
- 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
