Alpha Vantage Stock Analysis MCP Server

🚀 Alpha Vantage Stock MCP Server

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

🚀 Quick Start

This MCP server utilizes the Alpha Vantage API to offer stock market data. It enables Claude and other MCP clients to access both real - time and historical stock data.

✨ Features

• Retrieve intraday stock data with customizable intervals.
• Obtain daily stock data.
• Generate stock alerts based on price fluctuations.
• Access stock data as resources.

📦 Installation

Prerequisites

• Node.js version 16 or higher.
• An Alpha Vantage API key (Get it for free at Alpha Vantage).

Steps

1. Clone this repository.
2. Install the dependencies:

   npm install
   

3. Create a .env file in the project root directory and add your Alpha Vantage API key:

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

🔧 Build and Run

Build TypeScript code

npm run build

Run the server

npm start

Use auto - restart in the development environment

npm run dev

Test the API client

npm test

💻 Usage Examples

Use with Claude Desktop

To use this MCP server with Claude Desktop:

1. Open Claude Desktop.
2. Go to Settings > Developer > Edit Configuration.
3. Add the following content to claude_desktop_config.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 actual absolute path of the built index.js file. 4. Restart Claude Desktop.

Available Tools

get - stock - data

Retrieve intraday data for a specific stock. 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

Retrieve daily data for a specific stock. 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

Analyze stock data and generate price - fluctuation alerts. Parameters:

• symbol (Required): Stock symbol (e.g., IBM, AAPL).
• interval (Optional): Monitoring interval. Default: 5min.
• threshold (Optional): Fluctuation threshold percentage. Default: 2%.

Available Resources

Stock Data Resource

Access stock data via the following URI format:

stock://<symbol>[?<interval>&<outputsize>]

Parameters:

• symbol: Stock symbol.
• interval (Optional): Data interval, default is 5min.
• outputsize (Optional): Output size, either compact or full.

Example: Retrieve daily data for AAPL:

stock://AAPL?interval=1day&outputsize=full

📄 License

[Insert license information here]