StockData.Net MCP Server

关键词

股票数据金融数据JSON-RPC路由与故障转移实时数据获取

项目简介

StockData.Net 作为一个 MCP 服务器实现，提供一个用于向 AI 助手（如 Copilot、Claude、VS Code 等）提供金融市场数据、相关工具与提示模板的后端。服务器通过解析 MCP 请求、执行相应的资源/工具操作、并返回标准化的 JSON-RPC 响应，帮助模型在对话中获得可用的数据上下文和外部功能。

主要功能点

  • MCP 请求/响应处理
    • 支持 initialize、tools/list、tools/call 等核心 MCP 请求，并返回结构化响应。
  • 资源管理与数据访问能力
    • 集成股票历史价格、股票信息、新闻、市场新闻、股息与分割、财务报表、持仓信息、期权等多类数据的获取能力。
  • 工具注册与执行
    • 提供一组工具（如 获取历史价格、获取股票信息、获取新闻、市场新闻、获取财报等）供 LLM 调用，并返回文本/JSON 结果。
  • Prompt 模板与交互模式
    • 提供描述工具及能力，方便前端 client 渲染和组合对话场景。
  • 会话管理与能力声明
    • 通过配置承载路由、健康检查、容错等能力，确保在多 Provider 场景下的稳定性。
  • 多 Provider 路由与失效转移
    • 集成路由表和降级策略，允许对同一数据类型使用主提供者+回退提供者的组合，实现自动故障转移。
  • 健康监控与容错机制
    • 内置 Circuit Breaker、健康检查与故障统计，提升系统鲁棒性。
  • 安全与隔离
    • 将敏感信息以受保护的方式传递，避免在输出中泄露密钥等凭据。

安装与运行步骤

  • 需求与环境
    • 需有 .NET 6+/7+ 环境，能够编译并运行一个控制台应用。
  • 构建与部署
    • 构建成可执行文件后启动服务器进程，务必确保服务器具备对外暴露的可达性（按需可配置传输通道）。
  • 运行方式
    • 服务器通过标准输入输出进行 MCP 消息的接收与响应，启动后等待来自 MCP 客户端的 JSON-RPC 请求，并将响应输出到标准输出。
    • 典型的工作流程是客户端通过某种管道将 MCP 请求写入服务器进程的输入流，服务器处理后将 MCP 响应写回输出流。

服务器配置（MCP 客户端需要的配置信息说明）

说明：MCP 客户端需要的配置通常包含服务器标识、启动命令及参数等，以便建立与服务器的连接。以下为示例性描述信息，帮助理解配置内容；实际使用请以客户端文档为准。

  • 服务器名称（serverName）: StockData-mcp
  • 启动命令（command): StockData.Net.McpServer.exe
  • 启动参数（args）: [ "<path-to-config.json>" ]
    • 其中 config.json 包含提供商、路由、健康检查、速率限制等完整配置，服务器会在启动时加载并验证该配置。
  • 说明
    • MCP 客户端在连接时不需要深入理解服务器实现细节，只需通过该连接获取能力清单、调用工具并获取响应。
    • 配置中的路径需指向可访问的配置文件，服务器启动时会读取并应用。

基本使用方法

  • 启动服务器
    • 通过操作系统命令行启动可执行文件，传入配置文件路径作为参数。
  • 客户端交互（最简流程）
    • 发送 MCP 请求（JSON-RPC 2.0 风格），如初始化接口请求获取服务器能力描述；
    • 使用 tools/list 获取可用工具定义；
    • 使用 tools/call 调用具体工具（如获取历史价格、股票信息、新闻等），将产生的文本/JSON 结果返回给客户端，客户端再将结果融入对话上下文。
  • 常见注意事项
    • 确保提供的配置正确且可访问，尤其提供商密钥、路由与健康检查设置；
    • 在多 Provider 场景下，关注容错与回退策略的配置效果；
    • 使用时请遵循数据提供方的使用条款与速率限制。

运行后可用的基本使用示例

  • 通过 MCP 客户端请求初始化，获取服务器能力与服务器信息；
  • 查询工具列表，了解可调用的工具以及输入参数；
  • 调用具体工具获取数据（如历史价格、股票信息、新闻等），并将结果渲染给用户。

服务器信息

访问项目