使用说明

项目简介

berlinbra_alpha-vantage-mcp 是一个基于 Model Context Protocol (MCP) 标准构建的服务器，旨在为 LLM 应用提供实时的金融市场数据访问能力。它利用免费的 Alpha Vantage API 作为数据源，通过标准化的 MCP 接口，使得 LLM 客户端能够方便地获取股票、公司和加密货币的最新信息。

主要功能点

实时股票报价：获取股票的最新价格、涨跌幅、交易量等信息。
详细公司信息：查询公司的行业、市值、描述等基本面数据。
实时加密货币汇率：获取加密货币与法定货币之间的实时汇率。
历史时间序列数据：获取股票的历史每日价格数据。
错误处理：内置完善的错误处理机制，应对API速率限制、密钥无效等问题。

安装步骤

环境准备：确保已安装 Python 3.12 或更高版本。
安装依赖：使用 pip 安装必要的 Python 库 'mcp' 和 'httpx'。
```
pip install mcp httpx
```

服务器配置

为了让 MCP 客户端（例如 Claude 客户端）连接到 berlinbra_alpha-vantage-mcp 服务器，您需要配置客户端的 'claude_desktop_config.json' 文件。根据您的操作系统，找到该配置文件并添加以下 'mcpServers' 配置：

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在 'claude_desktop_config.json' 文件中，找到 '"mcpServers": { ... }' 部分，并添加或修改配置项 'alpha-vantage-mcp'，示例如下：

{
  "mcpServers": {
    "alpha-vantage-mcp": {  // 服务器名称，客户端使用此名称引用
      "command": "uv",      // 启动服务器的命令，这里假设使用 uv (uv 是一个快速的 Python 包安装器和运行器，仓库 README.md 中推荐使用)
      "args": [             // 传递给命令的参数列表
        "--directory",      // 指定工作目录
        "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp", //  **请替换为 alpha-vantage-mcp 仓库在您本地的绝对路径**
        "run",              // uv 的 run 子命令，用于运行 Python 模块或脚本
        "alpha-vantage-mcp" //  要运行的模块名，对应仓库中的 src/alpha_vantage_mcp/__init__.py 文件，该文件内部会调用 server.main() 启动服务器
      ],
      "env": {               // 环境变量配置
        "ALPHA_VANTAGE_API_KEY": "<insert api key>" // **请替换为您的 Alpha Vantage API 密钥**，您需要在 Alpha Vantage 官网注册并获取免费API密钥
      }
    }
  }
}

请务必按照注释说明，将 '{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp' 替换为您本地仓库的实际路径，并将 '<insert api key>' 替换为您自己的 Alpha Vantage API 密钥。

基本使用方法

启动服务器：在克隆到本地的 'alpha-vantage-mcp' 仓库目录下，打开终端并运行以下命令启动 MCP 服务器：
```
uv run src/alpha_vantage_mcp/server.py
```
或者根据 'claude_desktop_config.json' 中的配置，直接使用 'uv run alpha-vantage-mcp' （确保当前工作目录是仓库根目录）。
在 MCP 客户端中使用：配置完成后，在支持 MCP 的客户端（如 Claude 客户端）中，您应该能够看到名为 'alpha-vantage-mcp' 的服务器。客户端可以通过调用服务器提供的工具来获取金融数据。例如，在 Claude 中，您可以指示 Claude 使用 'get-stock-quote' 工具查询股票报价，并提供股票代码作为参数。

可用的工具包括：
- 'get-stock-quote': 获取股票报价
- 'get-company-info': 获取公司信息
- 'get-crypto-exchange-rate': 获取加密货币汇率
- 'get-time-series': 获取股票时间序列数据
具体工具的使用方法和参数，请参考仓库 README.md 文件中 “Available Tools” 部分的详细说明。

注意：Alpha Vantage API 有免费使用额度限制，请合理使用，避免触发速率限制。

关键词