Alphavantage MCP 服务器使用说明

项目简介

Alphavantage MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）客户端提供访问 Alphavantage 股票市场数据 API 的标准化接口。通过此服务器，LLM 可以便捷地获取股票、外汇、加密货币、商品和经济指标等金融数据，从而增强 LLM 在金融分析和相关应用中的能力。

主要功能点

全面的金融数据访问：支持股票、外汇、数字货币、大宗商品和经济指标等多种金融市场数据的查询。
丰富的API工具：提供超过100种不同的API工具，涵盖实时行情、历史数据、公司基本面、技术指标、市场新闻和情绪分析等。
标准化的MCP接口：遵循 MCP 协议，易于与各种 MCP 客户端集成，实现与 LLM 的无缝对接。
灵活的数据格式：支持 JSON 和 CSV 两种数据格式返回。
易于部署和配置：使用 Python 开发，配置简单，可以通过环境变量设置 API 密钥。

安装步骤

克隆仓库 打开终端，执行以下命令克隆 Alphavantage MCP 服务器仓库到本地：

git clone https://github.com/calvernaz/alphavantage.git
cd alphavantage

安装 Python 包 确保您的系统已安装 Python 环境。建议使用 'uv' 或 'pip' 等包管理器安装项目依赖：
```
uv pip install .
# 或
pip install .
```
配置 Alphavantage API 密钥
- 访问 Alphavantage 官网注册并获取免费 API 密钥。
- 将 API 密钥设置为环境变量 'ALPHAVANTAGE_API_KEY'。您可以通过以下方式设置（以 Linux/macOS 为例）：
```
export ALPHAVANTAGE_API_KEY="YOUR_API_KEY_HERE"
```
  或者，您也可以在启动服务器的命令中直接设置环境变量。

服务器配置

MCP 客户端需要配置服务器的启动命令才能连接 Alphavantage MCP 服务器。以下是 Claude Desktop 客户端的配置示例，其他 MCP 客户端的配置方式类似。

在 MCP 客户端的配置文件（例如 'claude_desktop_config.json'）中，添加如下 'mcpServers' 配置：

{
  "mcpServers": {
    "alphavantage": {
      "command": "uv",
      "args": [
        "--directory",
        "<仓库本地路径>/alphavantage",
        "run",
        "alphavantage_mcp_server"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
      },
      "serverName": "alphavantage" // (可选) 服务器名称，与配置名保持一致
    }
  }
}

配置参数说明：

'serverName': 服务器名称，客户端用以识别和调用，建议设置为 'alphavantage'。
'command': 启动服务器的命令，这里使用 'uv' (或 'python')。
'args': 命令参数，
- '--directory': 指定服务器代码所在的目录，请替换 '<仓库本地路径>' 为您克隆仓库的实际路径。
- 'run': 使用 'uv run' 运行 Python 模块。
- 'alphavantage_mcp_server': 指定要运行的 Python 模块为 'alphavantage_mcp_server'，对应 'src/alphavantage_mcp_server/init.py'。
'env': 环境变量配置，
- 'ALPHAVANTAGE_API_KEY': Alphavantage API 密钥，请替换 'YOUR_API_KEY_HERE' 为您实际的 API 密钥。

注意：

如果您没有安装 'uv'，可以将 'command' 更改为 'python'，并将 'args' 调整为 '["-m", "alphavantage_mcp_server"]'。
确保 '<仓库本地路径>/alphavantage' 指向您克隆仓库的实际路径。
将 'YOUR_API_KEY_HERE' 替换为您从 Alphavantage 官网获取的 API 密钥。

基本使用方法

启动 MCP 服务器：根据上述配置，启动 Alphavantage MCP 服务器。
配置 MCP 客户端：在 MCP 客户端中配置 Alphavantage MCP 服务器连接信息。
使用 LLM 调用工具：在 LLM 中，您可以指示其使用 'alphavantage' 服务器提供的工具来查询金融数据。例如，您可以指示 LLM 调用 'stock_quote' 工具来获取股票报价，或调用 'time_series_daily' 工具来获取股票日线数据。
查看返回结果：服务器会将 Alphavantage API 返回的 JSON 或 CSV 格式的数据封装在 MCP 响应中，LLM 客户端可以解析并使用这些数据。

请参考仓库 'src/alphavantage_mcp_server/server.py' 文件中 'AlphavantageTools' 枚举类和 '@server.list_tools()' 函数，了解所有可用的工具及其参数。

关键词