Volume-Price Analysis MCP Server

关键词

LLM上下文服务股票数据分析VWAP OBV MFI 指标JSON-RPC风险/趋势分析

使用说明（Markdown格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP 的服务器端，用于向 MCP 客户端（如支持 MCP 的大语言模型应用）提供统一的资源管理、工具执行以及提示渲染能力，专注于股票量价分析场景。

  • 主要功能点

    • 工具集合：提供多种股票数据分析工具，如获取股票数据(get_stock_data)、OBV、VWAP、Volume Profile、MFI、Volume Trends、综合分析、以及面向期权的分析等（包括 scan_candidates）。
    • 数据获取与处理：通过 nでpandas/yfinance 等实现数据获取、数据过滤和格式化输出。
    • MCP 服务器接口：实现 MCP 的服务器端入口，注册工具、返回符合 MCP Tool 结构的输入输出，以及使用 TextContent 将结果以 JSON 形式返回。
    • 多种传输模式：基于 MCP 标准设计，理论上支持如 STDIO、SSE、WebSocket 等传输，当前实现以 STDIO 为主。
    • 会话与能力声明：通过 InitializationOptions、Server.capabilities 进行能力声明与会话管理。

  • 安装步骤

    • 使用前提
      • 需要 Python 3.14 及以上环境
    • 常规安装
      • 安装依赖并在开发模式下安装
        • 具有 dev 依赖的安装方式：pip install -e ".[dev]"
        • 常规安装方式：pip install -e .
    • 运行服务器
      • 直接在命令行运行：python -m volume_price_analysis.server
    • 可选组件
      • 安装 yfinance、pandas、numpy 等数据处理相关依赖（通过上述安装方式自动获取）

  • 服务器配置（MCP 客户端需要的最小信息，JSON 格式） 注：以下配置用于 MCP 客户端在启动时知晓如何启动该 MCP 服务器及其名称等信息，其实质是在客户端侧的注册信息。请确保命名与客户端配置保持一致。 { "server_name": "volume-price-analysis", "command": "python", "args": ["-m", "volume_price_analysis.server"], "env": {} }

  • 基本使用方法

    • 启动方式
      • 在支持 MCP 的客户端环境中，将上述配置加入客户端的 MCP 设置，使客户端能够通过标准输入输出与服务器进行通讯。
    • 调用工具
      • 客户端通过 MCP 调用工具，如 get_stock_data、calculate_obv、analyze_volume_trends、comprehensive_analysis、options_analysis、scan_candidates 等，服务器返回标准化的 JSON-文本结果。
    • 数据格式与输出
      • 服务器返回的输出为 JSON 字符串，包含符号、数据点、指标、趋势、以及必要的元信息；某些工具也会返回多条 TextContent 内容，类型为文本文本内容。
    • 运行示例（CLI 情况）
      • 直接通过 Python 模块运行服务器（用于开发/测试）：python -m volume_price_analysis.server

服务器信息

访问项目