Alphavantage MCP Server使用说明

项目简介

Alphavantage MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供便捷的股票市场数据访问能力。它通过集成 Alphavantage API，将丰富的金融数据转化为 LLM 可以理解和利用的工具，帮助 LLM 在金融分析、投资决策等领域更好地服务用户。

主要功能点

实时和历史股票数据：支持获取股票的实时报价、日线、周线、月线等不同时间粒度的时间序列数据，包括调整后数据。
丰富的金融工具：提供包括股票、外汇、数字货币、商品、经济指标等多种金融市场的数据查询工具。
技术分析指标：内置多种常用的技术分析指标计算工具，如移动平均线 (SMA, EMA, WMA)、MACD、RSI、布林带等。
基本面数据：支持查询公司概况、ETF资料、财务报表（利润表、资产负债表、现金流量表）、分红、拆股、盈利日历等基本面数据。
市场情绪分析：提供新闻情感分析、热门股票（涨幅榜、跌幅榜）等另类数据。
灵活的数据格式：支持 JSON 和 CSV 两种数据返回格式。

安装步骤

克隆仓库

git clone https://github.com/MCP-Mirror/calvernaz_alphavantage.git
cd calvernaz_alphavantage

安装依赖 确保你的系统已安装 'uv' (或 'pip')。推荐使用 'uv' 进行更快速的包管理。

uv pip install .
# 或使用 pip
# pip install .

配置 Alphavantage API 密钥
- 访问 Alphavantage 官网注册并获取免费 API 密钥。
- 将 API 密钥设置为环境变量 'ALPHAVANTAGE_API_KEY'。例如，在 Linux/macOS 系统中，可以编辑 '~/.bashrc' 或 '~/.zshrc' 文件，添加以下行并替换为你的密钥：
```
export ALPHAVANTAGE_API_KEY="YOUR_API_KEY_HERE"
```
  然后执行 'source ~/.bashrc' 或 'source ~/.zshrc' 使环境变量生效。

服务器配置

MCP 客户端（如 Claude Desktop）需要以下配置信息来连接 Alphavantage MCP Server。将以下 JSON 配置添加到你的 MCP 客户端配置文件（例如 'claude_desktop_config.json'）的 'mcpServers' 字段中：

{
  "alphavantage": {  // 服务器名称，客户端据此名称引用
    "command": "uv",  // 启动服务器的命令，这里使用 uv
    "args": [         // 启动命令的参数
      "--directory",  // 指定工作目录
      "<DIRECTORY>/alphavantage", // 替换为alphavantage仓库的实际路径，例如 "/path/to/calvernaz_alphavantage"
      "run",          // uv run 命令
      "alphavantage" // 运行 alphavantage 入口点 (对应 __init__.py 中定义的 main 函数)
    ],
    "env": {           // 环境变量配置
      "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE" // 你的 Alphavantage API 密钥，虽然这里可以配置，但更推荐在系统环境变量中配置
    }
  }
}

注意:

请将 '<DIRECTORY>/alphavantage' 替换为克隆的 'calvernaz_alphavantage' 仓库在你的文件系统中的绝对路径。
'YOUR_API_KEY_HERE' 处的 API 密钥不是必须在这里配置的，更推荐在系统环境变量中配置 'ALPHAVANTAGE_API_KEY'，服务器会自动读取系统环境变量。如果系统环境变量和此处都配置了，此处配置会覆盖系统环境变量。
'command' 和 'args' 是客户端用来启动 MCP 服务器的关键信息，请确保配置正确。

基本使用方法

启动 MCP 客户端 (如 Claude Desktop)。
客户端会根据配置启动 Alphavantage MCP Server。
在 LLM 应用中，你可以通过 MCP 协议调用 Alphavantage MCP Server 提供的工具来查询股票数据。例如，你可以指示 LLM 调用 'stock_quote' 工具来获取 AAPL 的股票报价，或调用 'time_series_daily' 工具来获取 TSLA 的日线历史数据。

示例工具调用 (在 MCP 客户端中，以 JSON-RPC 格式发送请求):

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "stock_quote",
    "arguments": {
      "symbol": "AAPL"
    }
  },
  "id": 1
}

服务器会返回 AAPL 股票的实时报价数据。你可以参考 'src/mcp_server_alphavantage/server.py' 文件中 'handle_list_tools' 函数定义的工具列表和 'inputSchema' 来了解每个工具的具体参数和使用方法。

关键词