简介

这是一个提供来自Financial Datasets股票市场数据的模型上下文协议（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
   

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密钥
   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回答以下问题：

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