使用说明

项目简介

Alpha Vantage Stock Server 是一个 Model Context Protocol (MCP) 服务器，它利用 Alpha Vantage API 接口，为 Claude 等 MCP 客户端提供股票市场数据。通过该服务器，LLM 可以获取股票的实时和历史数据，进行股票分析和生成股票预警。

主要功能点

获取实时和历史股票数据：支持获取指定股票代码的日内和日线数据。
生成股票预警：根据股价波动生成预警信息，帮助用户监控股票市场动态。
资源访问：将股票数据作为资源托管，允许 LLM 通过标准 URI 访问数据。
工具调用：提供工具接口，允许 LLM 通过函数调用方式获取股票数据和预警。

安装步骤

克隆仓库

git clone https://github.com/ranveer0323/stock-analysis-mcp.git
cd stock-analysis-mcp

安装依赖 确保已安装 Node.js 16 或更高版本和 npm。
```
npm install
```
配置 API 密钥
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加 Alpha Vantage API 密钥。您可以在 Alpha Vantage 官网免费获取。
```
ALPHA_VANTAGE_API_KEY=YOUR_API_KEY_HERE
```
  请将 'YOUR_API_KEY_HERE' 替换为您自己的 API 密钥。
构建项目
```
npm run build
```

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude for Desktop），您需要提供服务器的启动命令和参数。以下是配置示例，请根据您的实际情况进行调整。

Claude for Desktop 配置 ( 'claude_desktop_config.json' )

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

配置参数说明:

'"alpha-vantage"': 服务器名称，您可以自定义。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行。
'"args": ["/absolute/path/to/dist/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'dist/index.js' 的绝对路径。 请务必将 '/absolute/path/to/dist/index.js' 替换为您本地 'dist/index.js' 文件的实际绝对路径。 例如，如果您的项目位于 '/Users/yourname/stock-analysis-mcp'，则 'args' 应该类似于 '["/Users/yourname/stock-analysis-mcp/dist/index.js"]'。
'"env": { "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY" }': 环境变量配置，用于传递 Alpha Vantage API 密钥。这里的 '"YOUR_API_KEY"' 建议与您在 '.env' 文件中设置的 API 密钥保持一致。您也可以直接在此处填写您的 API 密钥。

请注意：

配置完成后，需要重启 Claude for Desktop 使配置生效。

基本使用方法

启动服务器 在项目根目录下运行以下命令启动 MCP 服务器：
```
npm start
```
服务器成功启动后，将在控制台输出 'Alpha Vantage Stock MCP Server running on stdio'。
在 MCP 客户端中使用

资源访问示例 (在 Claude 中提问):
```
分析一下这支股票数据: stock://AAPL/daily
你觉得这个数据怎么样: stock://MSFT/5min
```
- 'stock://{symbol}/{interval}' 是资源 URI 模板。
- '{symbol}' 需要替换为股票代码，例如 'AAPL', 'MSFT'。
- '{interval}' 需要替换为时间间隔，例如 'daily', '1min', '5min', '15min', '30min', '60min'。
工具调用示例 (在 Claude 中提问，可能需要 Claude 支持工具调用功能):
```
获取 IBM 的实时股票数据
获取 AAPL 的日线数据
分析一下 TSLA 股票的预警
```
- 这些自然语言指令将被 MCP 客户端解析并转换为对服务器工具的调用。
- 可用的工具包括 'get-stock-data', 'get-daily-stock-data', 'get-stock-alerts'，具体参数请参考仓库 README.md 文件中 "Available Tools" 部分的描述。

通过以上步骤，您就可以成功安装、配置和使用 Alpha Vantage Stock MCP Server，在支持 MCP 协议的 LLM 应用中获取股票市场数据。

关键词