MaverickMCP Stock Analysis MCP 服务器

关键词

金融数据分析技术指标组合优化本地服务器SSE 接口

使用说明

  • 项目简介 MaverickMCP 是一个基于 FastMCP 2.0 的本地 MCP 服务器，专注于金融数据分析、技术指标计算、组合优化等工具的上下文服务。服务器通过 JSON-RPC 与 MCP 客户端通信，管理资源、注册工具、渲染 Prompts，并支持多种传输模式（HTTP、SSE、STDIO）以便与 Claude Desktop 等 MCP 客户端无缝集成。
  • 主要功能点
    1. MCP 核心能力：托管资源、工具与 Prompt 模板，提供标准化的 JSON-RPC 请求/响应，包含会话管理和能力声明。支持多传输模式，便于不同客户端接入。
    2. 资源与数据访问：提供股票数据、历史/实时信息、筛选结果等资源，便于 LLM 客户端读取和缓存。
    3. 工具与执行：内置多达 39+ 的金融分析工具，支持外部功能调用与并行执行，供 LLM 调用。
    4. Prompt 模板：提供可渲染的提示模板，便于构建统一的 LLM 交互场景。
    5. 多传输与集成：HTTP、SSE、STDIO 等传输，Claude Desktop 等 MCP 客户端可通过 mcp-remote 等工具接入。
    6. 本地开发与扩展性：提供开发工具、热重载、测试框架、并行研究与实验用模板，便于本地扩展新工具与新资源。
  • 安装与运行步骤
    1. 准备运行环境
      • Python 3.12+
      • 安装 uv（现代异步运行与部署工具）
      • 可能需要 TA-Lib、Redis（可选）等依赖，具体请参考 README。
    2. 获取代码与依赖
      • 克隆仓库，进入项目根目录。
      • 安装依赖并进入开发环境（README 提供了 uv sync 快速启动方式）。
    3. 数据与配置准备
      • 复制环境模板文件 (.env.example) 为实际环境配置，填入 TIINGO API KEY 等参数。
    4. 启动服务器
      • 运行 make dev，服务器将启动并提供以下端点：
        • HTTP 端点: http://localhost:8003/mcp/
        • SSE 端点: http://localhost:8003/sse/
        • 健康检查: http://localhost:8003/health
    5. 连接到 Claude Desktop 等 MCP 客户端
      • 推荐通过 SSE 进行稳定连接，确保额外的工具注册稳定性与会话持久性。
      • 通过 Claude Desktop 的配置文件（示例见 README）添加 MCP 服务器条目，使用 SSE 传输。
  • 服务器配置（MCP 客户端需要的最低启动信息） 服务器名称为 maverick-mcp，启动命令与参数示例如下（请在实际使用时替换为本地路径）： { "serverName": "maverick-mcp", "command": "uv", "args": ["run", "python", "-m", "maverick_mcp.api.server", "--transport", "sse"], "cwd": "/path/to/maverick-mcp" } 说明：以上配置用于在 MCP 客户端以 STDIO 转换为 HTTP/SSE 的方式接入 MCP 服务器。SSE 传输端点为 http://localhost:8003/sse/，请确保配置中的传输类型与客户端实际接入方式一致。若进行本地开发调试，亦可使用 STDIO 模式进行调试，但请仅在开发阶段使用。
  • 基本使用方法
    1. 启动后，客户端通过 SSE/HTTP 请求 MCP 服务器以获取资源、执行工具、渲染 Prompts。
    2. Claude Desktop 等客户端通过 mcp-remote 等工具将工具注册到 Claude，便于在对话中直接调用工具、读取资源与使用 Prompts。
    3. 开发者可通过 Makefile 提供的命令进行热重载、单元测试、性能测试等日常开发工作。
    4. 如遇工具注册、会话管理等问题，请参考 README 的排错部分（例如 SSE 端点需以 /sse/ 结尾以避免重定向问题）。

服务器信息

访问项目