Stock Analysis MCP

🚀 Alpha Vantage Stock MCP Server

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

🚀 Quick Start

This server allows you to access stock market data through the Alpha Vantage API, providing real - time and historical stock information to MCP clients such as Claude.

✨ Features

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

📦 Installation

Prerequisites

• Node.js 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 the TypeScript code

npm run build

Run the server

npm start

Use auto - reload during development

npm run dev

Test the API client

npm test

💻 Usage Examples

Integrate 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 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 path in your build directory.

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 to generate alerts related to price fluctuations.

Parameters:

• symbol (Required): Stock symbol (e.g., IBM, AAPL).
• threshold (Optional): Percentage threshold for price changes. 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:

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

📄 License

ISC