Alpha Vantage MCP 服务器

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

<a href="https://glama.ai/mcp/servers/0wues5td08"><img width="380" height="200" src="https://glama.ai/mcp/servers/0wues5td08/badge" alt="AlphaVantage-MCP MCP server" /></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 自动为 Claude Desktop 安装 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 .

运行

通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，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": "compact（最新的 100 个数据点）或 full（最多 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

贡献者

• berlinbra
• zzulanas

贡献

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

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。