MCP 概述
stock-sdk 内置 MCP（Model Context Protocol）server，一条命令即可启动，把 SDK 的只读行情能力暴露给 Cursor / Claude Desktop / Codex / Gemini 等 AI 工具，让模型直接取实时行情、K 线、搜索等数据。
stock-sdk mcp一键启动
MCP server 随主包一起发布，无需额外安装协议库。常见的两种用法：
# 通过 npx 一次性启动（AI 客户端配置里最常用）
npx -y stock-sdk mcp
# 或全局安装后直接调用
npm install -g stock-sdk
stock-sdk mcpserver 启动后通过 stdio（标准输入输出）与客户端通信，不监听任何网络端口。具体到各 AI 客户端的配置写法，见 MCP 安装配置。
设计要点
零依赖自实现协议
MCP 本质是 JSON-RPC 2.0 over 换行分隔（NDJSON）的 stdin/stdout。stock-sdk 没有引入 @modelcontextprotocol/sdk，而是自行手写了协议的最小子集，从而守住主包「零运行时依赖」的定位。
实现范围严格钉死在行情场景真正需要的部分：
- Transport：仅
stdio，不涉及 HTTP / SSE。 - 能力：仅
tools，不做 resources / prompts / sampling。 - 处理的方法：
initialize（握手与能力协商）、notifications/initialized、ping、tools/list、tools/call。
明确不做：HTTP / SSE transport、OAuth、sampling、progress / cancellation、resources / prompts 订阅、client 端。行情这类「一批只读方法」场景几乎用不到这些高级能力，需要时再扩展或评估切换官方 SDK。
不影响主包体积与零依赖
CLI 与 MCP 都走独立入口（stock-sdk/mcp），与主库严格单向隔离：
import { StockSDK } from 'stock-sdk'时，MCP 的代码一字节都不会进用户 bundle。- MCP 自身零第三方依赖，既不进用户 bundle，也不增加主包
node_modules。 - 仅编译产物
dist/mcp.*随 npm 包发布，小幅增加 tarball 体积。
工具从只读命名空间方法派生
server 暴露的每个 tool 对应一个 SDK 的只读命名空间方法（如 quotes / kline / search）。每个工具都是一份显式声明 —— name、description、手写 JSON Schema 的 inputSchema，以及把参数显式映射到 SDK 调用的 invoke，收进一份 manifest 作为单一事实源（SSOT），与 CLI 共用。工具概览见 MCP 工具表。
协议版本
server 维护一个支持版本数组，在 initialize 阶段与客户端协商并回退到双方都支持的版本，对应当前 MCP 规范的 stable 版本，并向后兼容上一稳定版。具体取值以实现与 MCP 规范当前版本为准。