使用说明(Markdown格式)

  • 项目简介

    • OpenMarkets MCP 服务器是一个面向 LLM 客户端的后端服务,按照 MCP(Model Context Protocol)规范组织资源、工具和提示模板等上下文信息,支持通过 JSON-RPC 进行请求与响应。服务器提供会话管理、能力声明以及对多种传输协议的支持(如标准输入输出、HTTP/SSE 等),以便 LLM 应用在生成或查询上下文时获取所需数据和外部功能。
  • 主要功能点

    • 资源管理:托管与管理可数据访问的 Resources,以供 LLM 读取和筛选。
    • 工具注册与执行:注册多类工具,LLM 通过调用工具来执行外部功能。
    • Prompt 定义与渲染:定义可自定义的 Prompt 模板,用于引导与渲染 LLM 的对话上下文。
    • JSON-RPC 通信:服务器通过标准的 JSON-RPC 协议与客户端交互,返回响应或发送通知。
    • 会话和能力声明:能够管理会话上下文、能力列表,向客户端暴露可用能力。
    • 多传输协议支持:支持 stdio、SSE、WebSocket 等传输模式,灵活接入不同应用场景。
    • 与 Yahoo Finance 等数据源的集成(示例工具集覆盖证券、市场、基金、分析、技术分析等领域)。
  • 安装步骤

    • 在本地环境安装依赖并运行服务器。服务器默认实现了通过 FastMCP 提供的服务能力和工具注册流程,启动后可通过 MCP 客户端连接使用。
  • 服务器配置

    • 说明:MCP 客户端在连接 MCP 服务器时,通常需要知道服务器名称、启动命令及参数等信息,以便启动并连接到 MCP 服务器。但本实现的客户端不需要在服务器端硬编码配置;客户端连接信息通常由客户端管理配置决定。下面提供一个参考性示例描述,用于理解配置要点。
    • 参考配置示例(JSON,供参考理解,实际客户端不需要在此处配置): { "server_name": "openmarkets", "command": "uvx", "args": ["openmarkets@latest"], "transport": "stdio" // 或 "http" 根据实际部署 } 注:该示例仅用于帮助理解客户端可能需要的字段;实际 MCP 客户端通常不需要在服务器端这段配置。服务器端会根据实现的 Settings 自动选择传输方式(stdio 或 http),并暴露相应的服务入口。
  • 基本使用方法

    • 启动服务器后,MCP 客户端(如 Claude Desktop、Cursor、自定义客户端等)可通过 MCP 的 JSON-RPC 形式请求:
      • 读取资源、获取工具、列出 Prompt、执行工具等上下文相关操作
    • 客户端可以通过服务器暴露的能力与工具,与金融数据、市场信息和分析数据进行交互,以驱动更具上下文感的对话生成。
  • 备注

    • 该实现基于开放的 FastMCP/MCP 框架,提供服务器端的工具注册、资源管理、Prompts 渲染等能力,强调后端作为 MCP 服务端的职责。

信息

分类

AI与计算