JinDaGe - stock-analysis-mcp MCP Details

article

README

🚀 Alpha Vantage 股票 MCP 服务器

这是一个借助模型上下文协议 (MCP) 构建的服务器，它能从 Alpha Vantage API 获取股票市场数据。Claude 及其他 MCP 客户端可通过该服务器访问实时和历史股票数据，为股票分析等应用场景提供有力支持。

✨ 主要特性

盘中数据获取：可获取带有可自定义间隔的盘中股票数据，满足不同频率的数据需求。
每日数据支持：能够获取每日股票数据，便于进行长期趋势分析。
股票警报生成：根据价格波动生成股票警报，让您及时掌握股票动态。
数据直接访问：可作为资源直接访问股票数据，使用更加便捷。

📦 安装指南

先决条件

Node.js 16 或更高版本
Alpha Vantage API 密钥（免费获取地址：Alpha Vantage）

安装步骤

克隆此仓库。
安装依赖项：
```
npm install
```
在项目根目录中创建一个 .env 文件，并添加您的 Alpha Vantage API 密钥：
```
ALPHA_VANTAGE_API_KEY=your_api_key_here
```

🚀 快速开始

构建和运行

构建 TypeScript 代码：

npm run build

运行服务器：

npm start

开发时使用自动重载：

npm run dev

测试 API 客户端：

npm test

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用，可按以下步骤操作：

打开 Claude 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"
      } 
    }
  }
}

将 /absolute/path/to/dist/index.js 替换为您构建目录中的实际路径。 4. 重启 Claude Desktop。

💻 使用示例

可用工具

get-stock-data

获取特定股票的盘中数据。 | 参数 | 详情 | |------|------| | symbol（必需） | 股票代码（例如 IBM、AAPL） | | interval（可选） | 数据点之间的间隔时间（1min、5min、15min、30min、60min）。默认值：5min | | outputsize（可选） | 返回的数据量（compact：最新 100 个数据点，full：最多 20 年的数据）。默认值：compact |

get-daily-stock-data

获取特定股票的每日数据。 | 参数 | 详情 | |------|------| | symbol（必需） | 股票代码（例如 IBM、AAPL） | | outputsize（可选） | 返回的数据量（compact：最新 100 个数据点，full：最多 20 年的数据）。默认值：compact |

get-stock-alerts

分析股票数据以生成价格波动相关的警报。 | 参数 | 详情 | |------|------| | symbol（必需） | 股票代码（例如 IBM、AAPL） | | threshold（可选） | 价格变动百分比阈值。默认值：5 |

可用资源

stock-data

直接作为资源访问股票数据。 URI 模板：stock://{symbol}/{interval} | 参数 | 详情 | |------|------| | symbol | 股票代码（例如 IBM、AAPL） | | interval | 时间间隔（每日、1min、5min、15min、30min、60min）。默认值：每日 |

示例用法：

“Can you analyze this stock data: stock://AAPL/daily”
“What do you think about this data: stock://MSFT/5min”

📄 许可证

本项目采用 ISC 许可证。

stock-analysis-mcp