使用说明（Markdown 格式）

• 项目简介

  • Stock Master MCP Server 是一个实现 MCP（Model Context Protocol）标准的后端服务器，面向股票分析、量化交易等场景，向 LLM 客户端提供标准化的资源、工具和模板等“上下文服务”。通过 JSON-RPC 与客户端进行交互，服务器端负责会话管理、能力声明以及对资源、工具、Prompts 的托管与渲染支持。
  • 服务器默认通过 STDIO 传输进行通信，理论上也支持通过 MCP 框架扩展实现 SSE/WebSocket 等传输。

• 主要功能点

  • 资源管理：提供资源清单、读取资源接口，资源可用于向 LLM 客户端提供数据和参考信息。
  • 工具注册与执行：定义并暴露一组工具，LLM 客户端可通过 JSON-RPC 请求调用工具执行外部功能（如数据下载、分析、回测等）。
  • 提示模版/Prompt 渲染：提供对 Prompt 模板的渲染与整合能力，便于 LLM 客户端以标准化方式获取可渲染的 Prompt 模板与上下文。
  • 会话与能力声明：具备对客户端会话的管理及服务器能力的描述能力，便于 LLM 客户端按需发现和利用服务器能力。
  • 多传输协议支持（理论上）：设计初衷是对接多种传输协议（如 STDIO、SSE、WebSocket），便于不同环境的集成。
  • 集成生态：仓库内包含完整的 MCP 服务端、资源/工具实现、示例及相关文档，且具备可运行的服务入口。

• 安装步骤

  • 准备环境：请使用 Python 3.10 及以上版本。
  • 安装依赖：在仓库根目录下安装所需的 Python 库（如 mcp、AkShare、Backtrader 等依赖，具体依赖请参考项目的 requirements/setup）。
  • 启动服务：在仓库中执行入口脚本启动 MCP 服务端。由于实现采用 MCP 框架的 stdio 传输，启动方式通常为直接运行服务入口（示例：以模块方式启动）。具体启动命令请参考仓库中 server.py 的入口定义及 README 的运行示例。
  • 客户端连接配置：MCP 客户端通过 JSON-RPC 与服务器通信，请在客户端配置中指定服务器名称、启动命令及参数（下方给出示例配置）。

• 服务器配置（MCP 客户端所需，JSON 配置文本，客户端无需执行） 说明：以下配置用于 MCP 客户端对接 Stock Master MCP Server。serverName、command、args 等字段基于仓库实际实现信息给出，JSON 值均以文本描述形式提供，便于粘贴到客户端配置中。请勿直接在代码块中粘贴，以免对终端用户造成误解。

  { "serverName": "Stock Master MCP Server", "command": "python -m stock_master_mcp", "args": { "transport": "stdio", "logLevel": "info", "host": "0.0.0.0", "port": 12345 }, "description": "MCP 服务端，基于模型上下文协议的股票云端上下文服务。默认传输为 STDIO，后续可扩展为 SSE/WebSocket。" }

  说明与提示：

  • serverName：服务器对外名称，便于客户端识别。
  • command：启动服务器的命令。当前实现的入口在 stock_master_mcp/server.py，示例给出通过 Python 模块启动的方式。
  • args：传递给服务器的参数集合。当前实现以 STDIO 为默认传输，若后续扩展支持其他传输，可以在此字段扩展。
  • transport、host、port 等字段仅在 MCP 框架允许时使用；当前实现的核心入口是 STDIO，因此实际使用时长度写法可简化为 STDIO。
  • description：对 MCP 服务器的简要描述，包含核心职责。

• 基本使用方法

  • 启动服务后，LLM 客户端通过 MCP 协议向服务器请求资源、调用工具、获取 Prompts 等。客户端在建立连接后即可发起 JSON-RPC 请求，服务器返回 JSON-RPC 响应或发布通知。
  • 常见操作包括：
    • 获取资源列表与读取资源内容，构建基于资源的上下文信息。
    • 注册并执行工具，LLM 可以在对话中调用工具以完成数据获取、运算、分析等任务。
    • 获取并渲染 Prompt 模板，用于引导 LLM 的对话风格和交互流程。
  • 若需要在本地快速试用，请参照仓库中的 README 与示例脚本，启动服务器后用 MCP 客户端连接并进行资源/工具查询。

• 备注

  • 该仓库包含完整的 MCP 服务端代码、资源/工具实现及示例使用，具备较完整的 MCP 服务端能力，只要依赖环境就可以在本地或服务器端运行。
  • 某些子模块（如 AkShare、Backtrader、CatBoost 等）在运行时可能需要额外的系统依赖，请参考各模块的文档安装。

• 参考示例（描述性用法，不作为代码块展示）

  • 使用 JavaScript/Python 等语言实现的 MCP 客户端通过读取上述 JSON 形式的服务器配置，启动进程并建立 JSON-RPC 通信通道。
  • 客户端可以调用服务器的资源接口，获取股票相关知识、读取资源模板等，进一步将上下文信息传递给大语言模型，完成对话驱动的分析与决策。

• 重要说明

  • 本 MCP 服务器实现围绕“资源、工具、Prompt 模板、会话管理、能力声明”等 MCP 核心要素设计，且提供了服务端入口、资源与工具的完整实现。若在实际部署中遇到依赖或运行问题，请参考仓库中的 README、dev_docs 与脚手架脚本以确保环境配置正确。