---
slug: "alpha-vantage-mcp服务器-alpha-vantage-mcp"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/septemhill/alpha_vantage_mcp@main/README.md"
repo: "https://github.com/septemhill/alpha_vantage_mcp"
source_file: "README.md"
branch: "main"
---
# Alpha Vantage MCP Server

This MCP server provides access to financial data from Alpha Vantage. It includes tools to retrieve OHLCV data, dividend data, and ETF holdings.

## Tools

### get_ticker_ohlcv

Get specific ticker OHLCV data (Open, High, Low, Close, Volume) for a given date.

**Input:**

```json
{
  "ticker": "AAPL",
  "infoType": "close",
  "date": "2024-01-02"
}
```

**Example Usage:**

To get the closing price of AAPL on January 2, 2024:

```bash
mcp call alpha_vantage get_ticker_ohlcv '{"ticker": "AAPL", "infoType": "close", "date": "2024-01-02"}'
```

### get_ticker_dividend

Get dividend data for a specific ticker.

**Input:**

```json
{
  "ticker": "AAPL"
}
```

**Example Usage:**

To get the dividend data for AAPL:

```bash
mcp call alpha_vantage get_ticker_dividend '{"ticker": "AAPL"}'
```

### get_etf_holdings

Get the holdings data for a specific ETF.

**Input:**
```json
{
  "ticker": "SPY"
}
```

**Example Usage:**

To get the holdings data for SPY:

```bash
mcp call alpha_vantage get_etf_holdings '{"ticker": "SPY"}'
```

### get_exchange_rate

Get the exchange rate between two currencies (fiat or crypto).

**Input:**

```json
{
  "fromCurrency": "USD",
  "toCurrency": "EUR"
}
```

**Example Usage:**

To get the exchange rate from USD to EUR:

```bash
mcp call alpha_vantage get_exchange_rate '{"fromCurrency": "USD", "toCurrency": "EUR"}'
```

### get_ticker_options

Get options data for a specific ticker.

**Input:**

```json
{
  "ticker": "AAPL"
}
```

**Example Usage:**

To get the options data for AAPL:

```bash
mcp call alpha_vantage get_ticker_options '{"ticker": "AAPL"}'
```

## Configuration

The server requires an Alpha Vantage API key to be set in the environment variable `ALPHAVANTAGE_API_KEY`.

To configure the MCP server, add the following to your MCP settings:

```json
{
  "mcpServers": {
    "github.com/septemhill/alpha_vantage_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpha_vantage_finance"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Replace `YOUR_API_KEY` with your Alpha Vantage API key.