Alpha Vantage MCP 服务器

这是一个模型上下文协议(MCP)服务器，通过免费的Alpha Vantage API提供实时金融市场数据访问。该服务器实现了标准化接口用于获取股票报价和公司信息。

功能特点

• 实时股票报价包含价格、交易量和涨跌幅数据
• 详细公司信息包括行业分类、所属板块和市值
• 实时加密货币汇率包含买卖报价
• 每日、每周和每月加密货币时间序列数据
• 实时期权链数据包含希腊值和隐含波动率
• 历史期权链数据支持高级筛选和排序
• 全面的ETF档案数据包含持仓、行业配置和关键指标
• 即将发布的财报日历支持自定义时间范围
• 历史财报数据包含年度和季度报告
• 内置错误处理和速率限制管理

安装指南

使用Claude桌面版

通过Docker安装

• 克隆仓库并构建本地镜像供Claude桌面客户端使用

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .

• 修改claude_desktop_config.json文件如下，将REPLACE_API_KEY替换为你的实际API密钥：

claude_desktop_config.json文件路径

• MacOS系统: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows系统: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

通过Smithery安装

通过Smithery为Claude桌面版自动安装Alpha Vantage MCP服务器：

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

{
 "mcpServers": {
  "alpha-vantage-mcp": {
   "args": [
    "--directory",
    "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp",
    "run",
    "alpha-vantage-mcp"
   ],
   "command": "uv",
   "env": {
    "ALPHA_VANTAGE_API_KEY": "<insert api key>"
   }
  }
 }
}

安装依赖包

uv install -e .

运行服务器

在通过json文件将Claude客户端与MCP工具连接并安装依赖包后，Claude应该能看到服务器的mcp工具：

你可以通过以下方式手动运行服务器： 在alpha-vantage-mcp仓库目录中:

uv run src/alpha_vantage_mcp/server.py

带检查器运行

* npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py `

可用工具

服务器实现了十二个工具：

• get-stock-quote: 获取指定公司的最新股票报价
• get-company-info: 获取指定公司的股票相关信息
• get-crypto-exchange-rate: 获取当前加密货币汇率
• get-time-series: 获取股票的历史每日价格数据
• get-realtime-options: 获取包含希腊值和隐含波动率的实时期权链数据
• get-historical-options: 获取支持高级筛选和排序功能的历史期权链数据
• get-etf-profile: 获取包含持仓和行业配置的全面ETF档案信息
• get-crypto-daily: 获取加密货币的每日时间序列数据
• get-crypto-weekly: 获取加密货币的每周时间序列数据
• get-crypto-monthly: 获取加密货币的每月时间序列数据
• get-earnings-calendar: 获取公司即将发布的财报日历数据
• get-historical-earnings: 获取指定公司的历史财报数据

get-stock-quote

输入模式:

{
    "symbol": {
        "type": "string",
        "description": "股票代码(如AAPL, MSFT)"
    }
}

示例响应:

AAPL股票报价:

价格: $198.50
涨跌幅: $2.50 (+1.25%)
成交量: 58942301
最高价: $199.62
最低价: $197.20

get-company-info

获取指定股票代码的详细公司信息。

输入模式:

{
    "symbol": {
        "type": "string",
        "description": "股票代码(如AAPL, MSFT)"
    }
}

示例响应:

AAPL公司信息:

名称: Apple Inc
行业板块: 科技
所属行业: 消费电子
市值: $3000000000000
简介: Apple Inc.设计、制造和销售智能手机...
交易所: 纳斯达克
货币: 美元

get-crypto-exchange-rate

获取包含额外市场数据的实时加密货币汇率。

输入模式:

{
    "crypto_symbol": {
        "type": "string",
        "description": "加密货币代码(如BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "市场货币(如USD, EUR)",
        "default": "USD"
    }
}

示例响应:

BTC/USD加密货币汇率:

来源: 比特币(BTC)
目标: 美元(USD)
汇率: 43521.45000
最后更新时间: 2024-12-17 19:45:00 UTC
买入价: 43521.00000
卖出价: 43522.00000

get-time-series

获取每日时间序列(OHLCV)数据，支持可选日期筛选。

输入模式:

{
    "symbol": {
        "type": "string",
        "description": "股票代码(如AAPL, MSFT)"
    },
    "outputsize": {
        "type": "string",
        "description": "compact(最新100个数据点)或full(最多20年数据)。当指定start_date或end_date时默认为'full'",
        "default": "compact"
    },
    "start_date": {
        "type": "string",
        "description": "可选: 筛选结果的开始日期，格式为YYYY-MM-DD",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "end_date": {
        "type": "string",
        "description": "可选: 筛选结果的结束日期，格式为YYYY-MM-DD",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "limit": {
        "type": "integer",
        "description": "可选: 当不应用日期筛选时返回的数据点数量(默认: 5)",
        "default": 5,
        "minimum": 1
    }
}

示例响应(近期数据):

AAPL时间序列数据(最后更新时间: 2024-12-17 16:00:00):
(显示最近的5个数据点)

日期: 2024-12-16
开盘价: $195.09
最高价: $197.68
最低价: $194.83
收盘价: $197.57
成交量: 55,751,011
---
日期: 2024-12-13
开盘价: $194.50
最高价: $196.25
最低价: $193.80
收盘价: $195.12
成交量: 48,320,567
---

示例响应(日期范围筛选):

AAPL时间序列数据(最后更新时间: 2024-12-17 16:00:00):
日期范围: 2024-12-01 至 2024-12-07 (5个数据点)

日期: 2024-12-06
开盘价: $191.25
最高价: $193.80
最低价: $190.55
收盘价: $192.90
成交量: 52,145,890
---
日期: 2024-12-05
开盘价: $189.75
最高价: $192.40
最低价: $188.90
收盘价: $191.30
成交量: 47,892,345
---

get-realtime-options

获取股票的实时期权链数据，支持可选希腊值计算和合约筛选。

⚠️ 需要高级订阅: 此端点需要Alpha Vantage高级版(600请求/分钟或1200请求/分钟计划)。标准的75请求/分钟计划和免费账户将收到占位/演示数据而非真实市场数据。对于大多数用例，建议使用get-historical-options，它适用于所有API密钥等级。

输入模式:

{
    "symbol": {
        "type": "string",
        "description": "股票代码(如AAPL, MSFT)"
    },
    "require_greeks": {
        "type": "boolean",
        "description": "可选: 启用希腊值和隐含波动率计算(默认: false)",
        "default": false
    },
    "contract": {
        "type": "string",
        "description": "可选: 要检索的特定期权合约ID"
    },
    "datatype": {
        "type": "string",
        "description": "可选: 响应格式(json或csv，默认: json)",
        "enum": ["json", "csv"],
        "default": "json"
    }
}

示例响应:

AAPL实时期权数据
最后更新时间: 2025-01-21 16:00:00

=== 到期日: 2025-01-24 ===

行权价: $220.0 (看涨期权)
最新价: $5.25
买入价: $5.10
卖出价: $5.30
成交量: 1250
未平仓合约: 8420
隐含波动率: 0.28
Delta值: 0.65
Gamma值: 0.02
Theta值: -0.15
Vega值: 0.45
Rho值: 0.12
---

行权价: $220.0 (看跌期权)
最新价: $1.85
买入价: $1.80
卖出价: $1.90
成交量: 820
未平仓合约: 5240
隐含波动率: 0.25
Delta值: -0.35
Gamma值: 0.02
Theta值: -0.12
Vega值: 0.42
Rho值: -0.08
---

注意: 上述示例显示的是真实市场数据，仅适用于Alpha Vantage高级版600+请求/分钟计划。免费账户或75请求/分钟计划的用户将看到占位数据(如"XXYYZZ"代码、"2099-99-99"日期)，应改用get-historical-options。

get-historical-options

获取历史期权链数据，支持高级筛选和排序功能以查找特定合约。

输入模式:

{
    "symbol": {
        "type": "string",
        "description": "股票代码(如AAPL, MSFT)"
    },
    "date": {
        "type": "string",
        "description": "可选: 交易日期的YYYY-MM-DD格式(默认为前一交易日，必须在2008-01-01之后)",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "expiry_date": {
        "type": "string",
        "description": "可选: 按到期日YYYY-MM-DD格式筛选",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "min_strike": {
        "type": "number",
        "description": "可选: 最低行权价筛选(如100.00)",
        "minimum": 0
    },
    "max_strike": {
        "type": "number",
        "description": "可选: 最高行权价筛选(如200.00)",
        "minimum": 0
    },
    "contract_id": {
        "type": "string",
        "description": "可选: 按特定合约ID筛选(如MSTR260116C00000500)"
    },
    "contract_type": {
        "type": "string",
        "description": "可选: 按合约类型筛选(看涨或看跌)",
        "enum": ["call", "put", "C", "P"]
    },
    "limit": {
        "type": "integer",
        "description": "可选: 筛选后返回的合约数量(默认: 10，使用-1返回所有合约)",
        "default": 10,
        "minimum": -1
    },
    "sort_by": {
        "type": "string",
        "description": "可选: 排序字段",
        "enum": ["strike", "expiration", "volume", "open_interest", "implied_volatility", "delta", "gamma", "theta", "vega", "rho", "last", "bid", "ask"],
        "default": "strike"
    },
    "sort_order": {
        "type": "string",
        "description": "可选: 排序顺序",
        "enum": ["asc", "desc"],
        "default": "asc"
    }
}

示例响应（基础版）：

AAPL股票历史期权数据（2024-02-20）：
状态：成功
共找到156份合约，按：行权价（升序）排序

合约详情：
合约代码：AAPL240315C00190000
到期日：2024-03-15
行权价：190.00美元
类型：看涨期权
最新价：8.45美元
买价：8.40美元
卖价：8.50美元
成交量：1245手
未平仓合约：4567手
隐含波动率：0.25
希腊值：
  Delta值：0.65
  Gamma值：0.04
  Theta值：-0.15
  Vega值：0.30
  Rho值：0.25
---

示例响应（筛选版）：

MSTR股票历史期权数据（2024-02-20）：
状态：成功
筛选条件：到期日：2026-01-16，行权价范围：400至600美元，类型：看涨期权
共找到3份合约，按：行权价（升序）排序

合约详情：
合约代码：MSTR260116C00000500
到期日：2026-01-16
行权价：500.00美元
类型：看涨期权
最新价：125.30美元
买价：124.50美元
卖价：126.10美元
成交量：89手
未平仓合约：1234手
---

获取ETF档案

获取ETF的完整档案信息，包括基础指标、行业配置和主要持仓。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "ETF代码（例如：QQQ、SPY、VTI）"
    }
}

示例响应：

QQQ ETF档案：

ETF档案

基础信息：
净资产：3527亿美元
费用率：0.200%
组合换手率：8.0%
股息率：0.50%
成立日期：1999-03-10
杠杆：否

行业配置：
信息技术：51.9%
通信服务：15.4%
非必需消费品：12.2%
必需消费品：4.8%
医疗保健：4.5%
工业：4.4%
公用事业：1.4%
原材料：1.3%
能源：0.5%
金融：0.4%

主要持仓：
 1. 英伟达公司（NVDA）：9.80%
 2. 微软公司（MSFT）：8.85%
 3. 苹果公司（AAPL）：7.35%
 4. 亚马逊公司（AMZN）：5.65%
 5. 博通公司（AVGO）：5.14%
 6. Meta Platforms A类股（META）：3.63%
 7. 奈飞公司（NFLX）：3.10%
 8. 特斯拉公司（TSLA）：2.66%
 9. Alphabet A类股（GOOGL）：2.49%
10. 好市多公司（COST）：2.49%

...以及其他92个持仓

总持仓数：102

获取加密货币日线数据

获取加密货币的日线时间序列数据。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "加密货币代码（例如：BTC、ETH）"
    },
    "market": {
        "type": "string",
        "description": "计价货币（例如：USD、EUR）",
        "default": "USD"
    }
}

示例响应：

SOL加密货币日线数据（美元计价）：

Solana（SOL）日线时间序列
市场：美元（USD）
最后更新时间：2025-04-17 00:00:00 UTC

日期：2025-04-17
开盘价：131.31000000美元
最高价：131.67000000美元
最低价：130.74000000美元
收盘价：131.15000000美元
成交量：39652.22195178
---
日期：2025-04-16
开盘价：126.10000000美元
最高价：133.91000000美元
最低价：123.46000000美元
收盘价：131.32000000美元
成交量：1764240.04195810
---

获取加密货币周线数据

获取加密货币的周线时间序列数据。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "加密货币代码（例如：BTC、ETH）"
    },
    "market": {
        "type": "string",
        "description": "计价货币（例如：USD、EUR）",
        "default": "USD"
    }
}

示例响应：

SOL加密货币周线数据（美元计价）：

Solana（SOL）周线时间序列
市场：美元（USD）
最后更新时间：2025-04-17 00:00:00 UTC

日期：2025-04-17
开盘价：128.32000000美元
最高价：136.00000000美元
最低价：123.46000000美元
收盘价：131.15000000美元
成交量：4823091.05667581
---
日期：2025-04-13
开盘价：105.81000000美元
最高价：134.11000000美元
最低价：95.16000000美元
收盘价：128.32000000美元
成交量：18015328.38860037
---

获取加密货币月线数据

获取加密货币的月线时间序列数据。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "加密货币代码（例如：BTC、ETH）"
    },
    "market": {
        "type": "string",
        "description": "计价货币（例如：USD、EUR）",
        "default": "USD"
    }
}

示例响应：

SOL加密货币月线数据（美元计价）：

Solana（SOL）月线时间序列
市场：美元（USD）
最后更新时间：2025-04-17 00:00:00 UTC

日期：2025-04-17
开盘价：124.51000000美元
最高价：136.18000000美元
最低价：95.16000000美元
收盘价：131.15000000美元
成交量：34268628.85976021
---
日期：2025-03-31
开盘价：148.09000000美元
最高价：180.00000000美元
最低价：112.00000000美元
收盘价：124.54000000美元
成交量：42360395.75443056
---

获取财报日历

获取公司即将发布的财报日历数据，支持自定义时间范围和排序方式。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "可选：股票代码，用于筛选特定公司的财报（例如：AAPL、MSFT、IBM）"
    },
    "horizon": {
        "type": "string",
        "description": "可选：财报数据的时间范围（3个月、6个月或12个月）",
        "enum": ["3month", "6month", "12month"],
        "default": "12month"
    },
    "limit": {
        "type": "integer",
        "description": "可选：返回的财报条目数量（默认：100）",
        "default": 100,
        "minimum": 1
    },
    "sort_by": {
        "type": "string",
        "description": "可选：排序字段",
        "enum": ["reportDate", "symbol", "name", "fiscalDateEnding", "estimate"],
        "default": "reportDate"
    },
    "sort_order": {
        "type": "string",
        "description": "可选：排序顺序",
        "enum": ["asc", "desc"],
        "default": "desc"
    }
}

示例响应（默认-按最新排序）：

财报日历（12个月范围）：

即将发布的财报日历（按报告日期降序排序）：

公司：英伟达（NVDA）
报告日期：2025-08-15
财年截止日：2025-07-31
预期每股收益：4.25美元
---
公司：苹果（AAPL）
报告日期：2025-07-30
财年截止日：2025-06-30
预期每股收益：1.85美元
---
公司：MicroStrategy（MSTR）
报告日期：2025-05-08
财年截止日：2025-03-31
预期每股收益：1.30美元
---
公司：MicroStrategy（MSTR）
报告日期：2025-02-06
财年截止日：2024-12-31
预期每股收益：1.25美元
---

示例响应（按股票代码排序）：

财报日历（12个月范围）：

即将发布的财报日历（按股票代码升序排序）：

公司：苹果（AAPL）
报告日期：2025-07-30
财年截止日：2025-06-30
预期每股收益：1.85美元
---
公司：Alphabet（GOOGL）
报告日期：2025-04-25
财年截止日：2025-03-31
预期每股收益：2.15美元
---
公司：MicroStrategy（MSTR）
报告日期：2025-02-06
财年截止日：2024-12-31
预期每股收益：1.25美元
---

获取历史财报数据

获取特定公司的历史财报数据，包括年度和季度报告。

输入参数：

{
    "symbol": {
        "type": "string",
        "description": "公司股票代码（例如：AAPL、MSFT、IBM）"
    },
    "limit_annual": {
        "type": "integer",
        "description": "可选：返回的年度财报数量（默认：5）",
        "default": 5,
        "minimum": 1
    },
    "limit_quarterly": {
        "type": "integer",
        "description": "可选：返回的季度财报数量（默认：8）",
        "default": 8,
        "minimum": 1
    }
}

示例响应：

MSTR历史财报数据：

=== 年度财报 ===
财年截止日：2023-12-31
报告每股收益：5.40美元
---
财年截止日：2022-12-31
报告每股收益：-9.98美元
---

=== 季度财报 ===
财季截止日：2024-09-30
报告日期：2024-10-30
报告每股收益：1.10美元
预期每股收益：0.98美元
超出预期：+0.12美元（+12.24%）
报告时间：盘后
---
财季截止日：2024-06-30
报告日期：2024-08-01
报告每股收益：1.05美元
预期每股收益：0.92美元
超出预期：+0.13美元（+14.13%）
报告时间：盘后
---

错误处理

服务器包含针对各种场景的全面错误处理机制：

• 超出速率限制
• 无效API密钥
• 网络连接问题
• 超时处理
• 格式错误的响应

错误信息将以清晰、易于理解的格式返回。

系统要求

• Python 3.12或更高版本
• httpx库
• mcp库

贡献者

• berlinbra
• zzulanas

参与贡献

欢迎贡献代码！请随时提交Pull Request。

许可证

本MCP服务器采用MIT许可证授权。 这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情请参阅项目仓库中的LICENSE文件。