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

阿尔法优势-MCP

作者：QuantML-C2 星标更新：2025-03-17
安装使用来源：spider==github.com

项目介绍

Alpha Vantage MCP 服务器

smithery 徽章

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

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

功能

  • 实时股票报价，包括价格、成交量和变化数据
  • 详细的公司信息，包括行业、板块和市值
  • 实时加密货币汇率，包括买入价和卖出价
  • 历史期权链数据，具有高级过滤和排序功能
  • 内置错误处理和速率限制管理

安装

使用 Claude Desktop

通过 Docker 安装

  • 克隆仓库并构建本地镜像以供您的 Claude Desktop 客户端使用
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • 修改您的 claude_desktop_config.json 文件以匹配以下内容，并用实际密钥替换 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-historical-options: 获取具有排序能力的历史期权链数据

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
货币：USD

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年的数据）",
        "default": "compact"
    }
}

示例响应：

AAPL 的时间序列数据（最后刷新时间：2024-12-17 16:00:00）：

日期：2024-12-16
开盘价：$195.09
最高价：$197.68
最低价：$194.83
收盘价：$197.57
成交量：55,751,011

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])$"
    },
    "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）：

合约 1：
执行价：$190.00
到期日：2024-03-15
最新价：$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

合约 2：
...

错误处理

服务器包括针对各种情况的全面错误处理：

  • 超出速率限制
  • 无效 API 密钥
  • 网络连接问题
  • 超时处理
  • 不良响应

错误消息以清晰易读的格式返回。

预备条件

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

贡献者

贡献

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

许可证

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