项目简介

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）集成。

安装步骤

克隆仓库:

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

安装 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 环境变量中。

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

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

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

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

启动 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) 和其他必要的参数才能获得准确的数据。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息