使用说明

项目简介

Alpha Vantage MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为大型语言模型 (LLM) 应用提供实时的金融市场数据。它通过集成 Alpha Vantage API，将股票、加密货币、外汇和技术分析等数据以工具的形式暴露给 LLM 客户端，使得 LLM 能够便捷地获取和利用最新的金融信息。

主要功能点

实时股票市场数据: 获取全球股票市场的实时报价、历史价格数据和公司信息。
加密货币数据: 提供实时加密货币价格和市场数据。
外汇交易数据: 支持实时外汇汇率和货币兑换信息。
技术分析指标: 提供多种技术分析指标，如移动平均线、动量指标等。
工具化数据访问: 所有数据均以 MCP 工具的形式提供，方便 LLM 通过标准化的方式调用和使用。

安装步骤

克隆仓库:

git clone https://github.com/deepsuthar496/alpha-ventage-mcp
cd alpha-ventage-mcp

安装依赖:
```
npm install
```
构建服务器:
```
npm run build
```

服务器配置

要将 Alpha Vantage MCP 服务器与 MCP 客户端连接，需要在客户端的 MCP 配置中添加以下服务器配置信息。请注意，你需要先在 Alpha Vantage 注册并获取 API 密钥，并将其设置为环境变量 'ALPHA_VANTAGE_API_KEY'。

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["path/to/alpha-ventage-mcp/build/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_API_KEY"  // 将 YOUR_ALPHA_VANTAGE_API_KEY 替换为你的 API 密钥
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置参数说明:

'"alpha-vantage"': 服务器名称，客户端使用此名称来调用该服务器提供的工具。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时。
'"args": ["path/to/alpha-ventage-mcp/build/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'index.js' 的路径。 请将 'path/to/alpha-ventage-mcp' 替换为你的 'alpha-ventage-mcp' 仓库在文件系统中的实际路径。
'"env": { "ALPHA_VANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_API_KEY" }': 设置环境变量，'ALPHA_VANTAGE_API_KEY' 用于存储你的 Alpha Vantage API 密钥。 请务必替换 'YOUR_ALPHA_VANTAGE_API_KEY' 为你实际的 API 密钥。
'"disabled": false': 设置为 'false' 表示启用该服务器。
'"alwaysAllow": []': 允许所有工具被调用 (可以根据需要配置访问控制)。

基本使用方法

配置完成后，在 MCP 客户端中，你可以使用 '<use_mcp_tool>' 标签来调用 Alpha Vantage MCP 服务器提供的工具。以下是一些示例：

获取股票实时价格:

<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_stock_price</tool_name>
<arguments>
{
  "symbol": "AAPL"
}
</arguments>
</use_mcp_tool>

获取比特币 (BTC) 价格:

<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_crypto_price</tool_name>
<arguments>
{
  "symbol": "BTC",
  "market": "USD"
}
</arguments>
</use_mcp_tool>

获取美元兑欧元汇率:

<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_forex_rate</tool_name>
<arguments>
{
  "from_currency": "USD",
  "to_currency": "EUR"
}
</arguments>
</use_mcp_tool>

获取苹果公司 (AAPL) 的日线移动平均线 (SMA):

<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_technical_indicator</tool_name>
<arguments>
{
  "symbol": "AAPL",
  "indicator": "SMA",
  "interval": "daily"
}
</arguments>
</use_mcp_tool>

更多工具和参数的详细信息，请参考仓库 'README.md' 文件和 'src/index.ts' 中的工具定义。

关键词