返回 MCP 目录
public公开dns本地运行

Financial Datasets

一个提供金融市场数据的MCP服务器,支持查询股票和加密货币的财务数据与价格信息

article

README

🚀 股票市场数据MCP服务器

这是一个提供来自Financial Datasets股票市场数据的模型上下文协议(MCP)服务器。它允许Claude和其他AI助手通过MCP界面直接获取收入报表、资产负债表、现金流量表、股票价格和市场新闻,为金融数据获取和分析提供了便捷途径。

🚀 快速开始

此MCP服务器提供了一系列实用工具,允许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包管理器

安装步骤

  1. 克隆此仓库:
git clone https://github.com/financial-datasets/mcp-server
cd mcp-server
  1. 如果尚未安装uv,请进行安装:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell
  1. 安装依赖项:
# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate  # 在Windows上:.venv\Scripts\activate

# 安装依赖项
uv add "mcp[cli]" httpx  # 在Windows上:uv add mcp[cli] httpx
  1. 设置环境变量:
# 复制示例文件并配置API密钥
cp .env.example .env

# 在.env文件中设置API密钥
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
  1. 运行服务器:
uv run server.py

📚 详细文档

配置Claude Desktop

  1. 如果尚未安装,请下载并安装Claude Desktop
  2. 创建或编辑Claude Desktop配置文件:
# macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加以下配置:
{
  "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替换为该项目的绝对路径。 4. 重启Claude Desktop。 5. 现在您应该可以在Claude Desktop工具菜单(锤子图标)中看到金融工具。 6. 您可以尝试让Claude回答以下问题:

  • “Apple最近的收入报表是什么?”
  • “显示特斯拉股票的当前价格”
  • “获取MSFT从2024 - 01 - 01到2024 - 12 - 31的历史价格”
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端