Financial Datasets MCP Server

关键词

金融数据股票市场财务报表股票价格市场新闻

项目简介

Financial Datasets MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它作为 MCP 服务器，旨在为 Claude 等大型语言模型 (LLM) 提供访问金融市场数据的能力。通过此服务器，LLM 可以便捷地获取上市公司的财务报表（如 income statements, balance sheets, cash flow statements）、股票价格以及市场新闻等信息，从而增强 LLM 在金融分析和信息检索方面的能力。

主要功能点

  • 财务报表数据访问: 提供获取上市公司 Income Statements（利润表）、Balance Sheets（资产负债表）和 Cash Flow Statements（现金流量表）的工具。
  • 股票价格数据访问: 支持获取股票的当前价格和历史价格数据，并允许自定义日期范围和时间间隔。
  • 市场新闻数据访问: 提供获取公司最新市场新闻的工具，帮助 LLM 了解公司动态和市场情绪。
  • 加密货币数据支持: 除了股票数据，还支持获取加密货币的价格数据和可用交易代码列表。
  • 基于标准 MCP 协议: 遵循 MCP 协议规范，易于与支持 MCP 协议的客户端（如 Claude Desktop）集成。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/financial-datasets/mcp-server
cd mcp-server

  2. 安装 uv (可选，推荐): uv 是一个快速的 Python 包安装和依赖管理工具。如果已安装可跳过。

    # macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell

    确保 'uv' 命令在您的 PATH 环境变量中。

  3. 创建并激活虚拟环境，安装依赖:

    uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows
uv add "mcp[cli]" httpx

  4. 配置 API 密钥: 复制 '.env.example' 文件为 '.env'，并编辑 '.env' 文件，填入您的 Financial Datasets API 密钥。您需要在 Financial Datasets 网站注册并获取 API 密钥。

    cp .env.example .env
# 编辑 .env 文件，设置 FINANCIAL_DATASETS_API_KEY

  5. 启动 MCP 服务器:

    uv run server.py

    服务器默认使用 stdio 传输协议，在终端前台运行。

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。

{
  "mcpServers": {
    "financial-datasets": {  // 服务器名称，您可以自定义
      "command": "/path/to/uv",  // uv 命令的绝对路径，可以使用 'which uv' 命令查找
      "args": [
        "--directory",
        "/absolute/path/to/mcp-server", // mcp-server 仓库的绝对路径
        "run",
        "server.py"
      ]
    }
  }
}

请务必替换以下占位符：

  • '/path/to/uv': 替换为 'uv' 命令的绝对路径。您可以使用 'which uv' 命令在终端中查找 'uv' 的安装路径，并复制结果替换此占位符。例如，如果 'which uv' 输出 '/Users/your_username/.local/bin/uv'，则应替换为 '/Users/your_username/.local/bin/uv'。
  • '/absolute/path/to/mcp-server': 替换为您 mcp-server 仓库在您本地文件系统中的绝对路径。例如，如果您将仓库克隆到 '/Users/your_username/Documents/mcp-server'，则应替换为 '/Users/your_username/Documents/mcp-server'。

完成配置后，重启 Claude Desktop 客户端，您应该能在工具菜单（锤子图标）中看到 "financial-datasets" 服务器提供的工具。

基本使用方法

成功连接后，您可以在 Claude Desktop 中通过自然语言指令调用 MCP 服务器提供的工具。例如：

  • 询问 Apple 公司的近期利润表: "What are Apple's recent income statements?"
  • 查询 Tesla 股票的当前价格: "Show me the current price of Tesla stock"
  • 获取微软股票 2024 年 1 月 1 日至 2024 年 12 月 31 日的历史价格: "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"

LLM 将会调用相应的工具并返回结果。请注意，您需要提供有效的股票代码 (Ticker Symbol) 和其他必要的参数才能获得准确的数据。

服务器信息

访问项目