金融数据集 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 包管理器

安装

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. 设置环境变量：

   # 创建 .env 文件以存储您的 API 密钥
   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 的历史价格"