关键词

金融数据股票信息公司信息加密货币市场数据

使用说明

项目简介

Alpha Vantage MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它通过与 Alpha Vantage API 接口通信，为大型语言模型 (LLM) 客户端提供实时的金融市场数据。该服务器旨在使 LLM 能够方便地访问和利用最新的金融信息，从而增强 LLM 在金融领域的应用能力。

主要功能点

  • 实时股票报价: 提供股票的最新价格、交易量、涨跌幅等实时数据。
  • 公司信息: 提供公司的基本面信息，例如公司名称、所属行业、市值、公司描述等。
  • 加密货币汇率: 提供实时的加密货币与法定货币之间的兑换汇率。
  • 历史时间序列数据: 提供股票的历史每日价格数据，用于分析和回溯。
  • 历史期权链数据: 提供股票的历史期权链数据，支持用户进行高级的期权分析。

安装步骤

  1. 安装 Python: 确保你的系统已安装 Python 3.12 或更高版本。
  2. 安装依赖: 克隆仓库到本地后，在项目根目录下打开终端，运行命令 'uv install -e .' 安装项目所需的 Python 依赖库。
  3. 获取 Alpha Vantage API 密钥: 访问 Alpha Vantage 官网 注册并获取免费的 API 密钥。
  4. 配置 API 密钥: 将获取到的 API 密钥设置为环境变量 'ALPHA_VANTAGE_API_KEY'。或者，你也可以修改 'src/alpha_vantage_mcp/server.py' 文件，将 API 密钥直接填入 'API_KEY = os.getenv('ALPHA_VANTAGE_API_KEY')' 这行代码中（不推荐，建议使用环境变量）。

服务器配置

以下是在 MCP 客户端中配置 Alpha Vantage MCP Server 的示例 JSON 配置信息。你需要将 '{YOUR_REPO_PATH}' 替换为你本地仓库的实际路径，并将 '<YOUR_API_KEY>' 替换为你从 Alpha Vantage 获取的 API 密钥。

{
    "mcpServers": {
        "alpha-vantage-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "{YOUR_REPO_PATH}",  // 替换为你的仓库路径，例如：/Users/yourname/alpha-vantage-mcp
                "run",
                "src/alpha_vantage_mcp/server.py"
            ],
            "env": {
                "ALPHA_VANTAGE_API_KEY": "<YOUR_API_KEY>"  // 替换为你的 Alpha Vantage API 密钥
            }
        }
    }
}

基本使用方法

  1. 启动服务器: 在项目根目录下，运行命令 'uv run src/alpha_vantage_mcp/server.py' 启动 Alpha Vantage MCP Server。
  2. 配置 MCP 客户端: 将上面提供的服务器配置 JSON 信息添加到你的 MCP 客户端配置中。例如，如果你使用 Claude Desktop，则需要修改 'claude_desktop_config.json' 文件。
  3. 在 LLM 中使用: 在支持 MCP 协议的 LLM 应用中，你可以指示 LLM 使用 'get-stock-quote'、'get-company-info' 等工具来获取金融数据。LLM 将自动调用 Alpha Vantage MCP Server 提供的工具，并将结果返回给你。

注意: 使用 Alpha Vantage API 可能会受到速率限制，请参考 Alpha Vantage API 文档 了解详细的速率限制信息。

信息

分类

网页与API

访问项目