Financial Datasets

官方

为AI代理打造的股票市场API

GitHub

2.2k

你可以用 Financial Datasets MCP 做什么？

获取利润表 — 使用 get_income_statements 检索公司的利润表。
获取资产负债表 — 使用 get_balance_sheets 检索公司的资产负债表。
获取现金流量表 — 使用 get_cash_flow_statements 检索公司的现金流量表。
获取当前股票或加密货币价格 — 通过 get_current_stock_price 或 get_current_crypto_price 查询某个代码的最新价格。
获取历史股票或加密货币价格 — 使用 get_historical_stock_prices 或 get_historical_crypto_prices 拉取指定日期范围的历史价格数据。
获取公司新闻 — 使用 get_company_news 检索公司的最新新闻文章。

文档

Financial Datasets MCP 服务器

简介

这是一个模型上下文协议（MCP）服务器，提供来自 Financial Datasets 的股票市场数据访问。

它允许 Claude 和其他 AI 助手通过 MCP 接口直接获取利润表、资产负债表、现金流量表、股票价格和市场新闻。

可用工具

此 MCP 服务器提供以下工具：

get_income_statements：获取公司的利润表。
get_balance_sheets：获取公司的资产负债表。
get_cash_flow_statements：获取公司的现金流量表。
get_current_stock_price：获取公司当前/最新价格。
get_historical_stock_prices：获取公司的历史股票价格。
get_company_news：获取公司新闻。
get_available_crypto_tickers：获取所有可用的加密货币代码。
get_crypto_prices：获取加密货币的历史价格。
get_historical_crypto_prices：获取加密货币的历史价格。
get_current_crypto_price：获取加密货币的当前/最新价格。

设置

前提条件

Python 3.10 或更高版本
uv 包管理器

安装

克隆此仓库：

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

如果你尚未安装 uv，请安装它：

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

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

安装依赖项：

# Create virtual env and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx

设置环境变量：

# Create .env file for your API keys
cp .env.example .env

# Set API key in .env
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

运行服务器：
```
uv run server.py
```

连接到 Claude Desktop

如果你还没有安装 Claude Desktop，请先安装

创建或编辑 Claude Desktop 配置文件：

# macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "financial-datasets": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/financial-datasets-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

将 /path/to/uv 替换为 which uv 的结果，并将 /absolute/path/to/financial-datasets-mcp 替换为此项目的绝对路径。

重启 Claude Desktop
现在你应该能在 Claude Desktop 的工具菜单（锤子图标）中看到这些金融工具
尝试向 Claude 提问，例如：
- "苹果公司最近的利润表是什么？"
- "显示特斯拉股票的当前价格"
- "获取 MSFT 从 2024-01-01 到 2024-12-31 的历史价格"