STARWARCLOUD STARWAR.AI
返回市场
阿尔法优势MCP

阿尔法优势MCP

作者：berlinbra82 星标更新：2025-10-22
安装使用来源：spider==github.com

项目介绍

Alpha Vantage MCP Server

smithery 徽章

这是一个通过免费的 Alpha Vantage API 提供实时金融市场数据访问的 Model Context Protocol (MCP) 服务器。此服务器实现了用于检索股票报价和公司信息的标准接口。

<a href="https://glama.ai/mcp/servers/0wues5td08"><img width="380" height="200" src="https://gips1.baidu.com/it/u=3051289683,1596527095&fm=3081&app=3081&f=PNG?w=760&h=400" alt="AlphaVantage-MCP MCP 服务器" /></a>

功能

  • 实时股票报价，包括价格、成交量和变化数据
  • 详细的公司信息，包括行业、市场板块和市值
  • 实时加密货币汇率，包括买入价和卖出价
  • 每日、每周和每月的加密货币时间序列数据
  • 实时期权链数据，包括希腊字母和隐含波动率
  • 历史期权链数据，具有高级过滤和排序功能
  • 综合的ETF概况数据，包括持仓、行业分配和关键指标
  • 可定制时间范围的即将发布的收益日历
  • 历史收益数据，包括年度和季度报告
  • 内置错误处理和速率限制管理

安装

使用 Claude Desktop

通过 Docker 安装

  • 克隆仓库并构建本地镜像以供您的 Claude Desktop 客户端使用
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • 更改您的 claude_desktop_config.json 文件以匹配以下内容，并用实际的 API 密钥替换 REPLACE_API_KEY：

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 自动安装 Alpha Vantage MCP 服务器：

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude
<summary><h3> 开发/未发布服务器配置 </h3></summary> <details> 
{
 "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>"
   }
  }
 }
}
</details>

安装包

uv install -e .

运行

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

您可以自己运行服务器： 在 alpha-vantage-mcp 仓库中：

uv run src/alpha_vantage_mcp/server.py

使用 inspector：

* 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. 设计、制造和销售智能手机...
交易所：NASDAQ
货币：美元

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": "紧凑（最近100个数据点）或完整（最多20年的数据）。当指定 start_date 或 end_date 时，默认为 '完整'",
        "default": "紧凑"
    },
    "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": 1
    },
    "contract_id": {
        "type": "string",
        "description": "可选：按具体合约ID过滤（例如，MSTR260116C00000500）"
    },
    "contract_type": {
        "type": "string",
        "description": "可选：按合约类型过滤（看涨或看跌）",
        "enum": ["看涨", "看跌", "C", "P"]
    },
    "limit": {
        "type": "integer",
        "description": "可选：过滤后返回的合约数量（默认：10，使用-1表示所有合约）",
        "default": 10,
        "minimum": -1
    },
    "sort_by": {
        "type": "string",
        "description": "可选：排序字段",
        "enum": ["行权价", "到期日", "成交量", "未平仓合约数", "隐含波动率", "Delta", "Gamma", "Theta", "Vega", "Rho", "最新价", "买入价", "卖出价"],
        "default": "行权价"
    },
    "sort_order": {
        "type": "string",
        "description": "可选：排序顺序",
        "enum": ["升序", "降序"],
        "default": "升序"
    }
}

示例响应（基本）：

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

合约详情：
合约ID：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个合约，按：行权价（升序）排序

合约详情：
合约ID：MSTR260116C00000500
到期日：2026-01-16
行权价：$500.00
类型：看涨
最新价：$125.30
买入价：$124.50
卖出价：$126.10
成交量：89
未平仓合约数：1234
---

get-etf-profile

检索综合的ETF概况信息，包括基本指标、行业分配和主要持仓。

输入模式：

{
    "symbol": {
        "type": "string",
        "description": "ETF代码（例如，QQQ，SPY