关键词

股票市场金融数据Alpha Vantage API实时行情公司财务报表

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在为 LLM 应用提供股票市场相关的数据访问能力。它通过 Alpha Vantage API 获取实时股票价格、公司财务报表、市场报告和公司概览信息，并以标准化的 MCP 协议与客户端进行通信。

主要功能点

  • 获取股票实时价格 (get_ticker_price): 查询指定股票代码的最新价格。
  • 获取美国市场报告 (get_market_report): 获取美国股票市场的整体状况概览。
  • 获取公司财务报表 (get_financial_statement): 获取上市公司的收入报表、资产负债表或现金流量表。
  • 获取公司概览信息 (get_company_overview): 获取公司的基本信息和关键财务指标。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 将仓库 'https://github.com/MCP-100/stock-market-server' 克隆到本地。
  3. 安装依赖: 在仓库根目录下打开终端，运行命令 'npm install' 安装项目依赖。
  4. 构建项目: 运行命令 'npm run build' 构建项目，生成可执行的 JavaScript 文件。

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 Claude Desktop），你需要配置服务器信息。以下是配置示例，你需要根据你的实际情况进行调整。

配置文件路径：

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

配置内容示例 (json):

{
  "mcpServers": {
    "stock-market-server": {  // 服务器名称，可以自定义，用于在客户端中标识
      "command": "/path/to/stock-market-server/build/index.js" //  'index.js' 文件的绝对路径，请替换为你的实际路径
      // "args": [] //  可选：如果启动命令需要参数，可以在这里配置，本服务器默认不需要参数
    }
  }
}

注意:

  • 请将 '"command"' 字段的值 '/path/to/stock-market-server/build/index.js' 替换为你本地 'stock-market-server' 仓库中 'build/index.js' 文件的绝对路径。你可以通过终端进入 'build' 目录，然后使用 'pwd' (MacOS/Linux) 或 'Get-Location' (Windows PowerShell) 命令获取当前目录的绝对路径，然后拼接上 'index.js'。
  • '"server name"' '"stock-market-server"' 可以自定义，用于在客户端中识别和管理你的 MCP 服务器。

基本使用方法

  1. 启动服务器: 配置完成后，MCP 服务器会在客户端（如 Claude Desktop）需要时自动启动。你无需手动运行 'index.js' 文件。
  2. 客户端调用工具: 在支持 MCP 协议的 LLM 客户端中，你可以指示 LLM 使用 'stock-market-server' 提供的工具来获取股票市场数据。例如，你可以向 Claude 提问：
    • "请使用 'get_ticker_price' 工具查询 AAPL 的股价"
    • "使用 'get_financial_statement' 工具获取 TSLA 的收入报表"
    • "请使用 'get_market_report' 工具获取今天的美国市场报告"

重要提示:

  • 本服务器默认使用了 Alpha Vantage 提供的免费 API 密钥 'UM3APW59708M49EH'。为了更好的使用体验和避免API调用频率限制，建议你注册 Alpha Vantage 账号 并获取自己的 API 密钥，然后在 'src/index.ts' 文件中替换 'API_KEY' 变量的值。

信息

分类

网页与API

访问项目