金融数据服务

一个基于Model Context Protocol (MCP)的服务器,通过Yahoo Finance API为大型语言模型提供实时金融数据。

  • by dino65-dev
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dino65-dev/Finance_mcp-server

使用说明

财务_mcp-server

一种模型上下文协议(MCP)服务器,通过雅虎财经向大型语言模型提供实时财务数据。

该项目创建了一个MCP服务器,允许Claude等人工智能模型通过雅虎财经API访问实时股票和财务数据。该服务器实现了模型上下文协议标准,实现了与各种MCP客户端的无缝集成,包括Claude Desktop、Cursor、Winds AI等。

🚀 特性

  • 实时股票价格查询:获取任何上市公司的当前价格
  • 历史数据分析:检索自定义时间段内的股票表现
  • 公司信息:访问详细的公司简介和财务指标
  • 库存比较:根据各种指标比较多只股票
  • 股票搜索:按公司名称或关键字查找相关股票
  • 资源访问:使用结构化URI方案访问财务数据

📋 需求

💻 安装

  1. 克隆此存储库:

    git clone https://github.com/dino65-dev/Finance_mcp-server.git
    
  2. 创建虚拟环境:

    python -m venv venv
    On Windows: venv\Scripts\activate
    

创建虚拟环境(推荐)以加快创建速度:

pip install uv
uv venv
On Windows: venv\Scripts\activate
  1. 安装依赖项:
    pip install -r requirements.txt
    

🔧 用法

运行服务器

通过运行以下命令启动服务器:

python yfinance_mcp_server.py

服务器将作为通过MCP协议进行通信的stdin/stdout进程运行。

与MCP客户端集成

克劳德桌面

  1. 打开克劳德桌面
  2. 转到“设置”
  3. 添加MCP配置,包括:
    {
      "mcpServers": {
        "yfinance": {
          "command": "python",
          "args": [
            "/absolute/path/to/yfinance_mcp_server.py"
          ]
        }
      }
    }
    
  4. 保存并重新启动Claude Desktop

光标

  1. 打开光标并访问设置
  2. 导航到MCP部分
  3. 添加一个新的全局MCP服务器,配置如下:
    {
      "yfinance": {
        "command": "python",
        "args": [
          "/absolute/path/to/yfinance_mcp_server.py"
        ]
      }
    }
    
  4. 开始新的聊天以使用金融工具

📊 可用工具

服务器提供以下工具:

  1. get_stock_price:获取当前股票价格

    Example: Get the current price of Apple stock
    
  2. get_historical_data:检索历史价格数据

    Example: Get the stock history for TSLA over the past 3 months
    
  3. get_stock_metric:访问特定的财务指标

    Example: What is Amazon's market capitalization?
    
  4. compare_stocks:按指标比较多只股票

    Example: Compare the P/E ratios of Google, Microsoft, and Apple
    
  5. search_stocks:按名称或关键字查找股票

    Example: Find stocks related to artificial intelligence
    

🔍 资源URI

直接通过资源URI访问股票信息:

  • finance://SYMBOL/info -获取股票的基本信息

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

🙏 致谢

📞 贡献

欢迎投稿!请随时提交拉取请求。