金融数据集 MCP 服务器

简介

这是一个模型上下文协议（MCP）服务器，提供了从 Financial Datasets 获取股票市场数据的接口。

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

可用工具

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

• get_income_statements: 检索某只股票的损益表
• get_balance_sheets: 检索某只股票的资产负债表
• get_cash_flow_statements: 检索某只股票的现金流量表
• get_current_price: 获取某只股票的最新价格信息
• get_prices: 获取具有可定制日期范围和间隔的历史股票价格
• get_news: 获取某只股票的最新新闻

设置

前提条件

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

安装

1. 克隆此仓库：

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

2. 如果您还没有安装 uv，请进行安装：

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

3. 安装依赖项：

   # 创建虚拟环境并激活它
   uv venv
   source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate
   
   # 安装依赖项
   uv add "mcp[cli]" httpx  # 在 Windows 上: uv add mcp[cli] httpx
   

4. 设置环境变量：

   # 为您的 API 密钥创建 .env 文件
   cp .env.example .env
   
   # 在 .env 中设置 API 密钥
   FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
   

5. 运行服务器：

   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
   

3. 添加以下配置：

   {
     "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 提问，例如：

   • "苹果公司最近的损益表是什么？"
   • "显示特斯拉股票的当前价格"
   • "获取 MSFT 从 2024-01-01 到 2024-12-31 的历史价格"