tvscreener MCP 服务器

使用说明(Markdown 格式)

  • 项目简介

    • tvscreener MCP 服务器将 TV Screener 的字段发现、字段类别查询、自由格式查询以及股票/加密货币/外汇等市场筛选等能力以 MCP 工具的形式对外暴露,供A级 AI 客户端(如 Claude 等)通过 MCP 协议访问。
  • 主要功能点

    • 字段发现与筛选:discover_fields、list_field_types、search 字段、字段类别查询
    • 自由查询工具:custom_query,支持任意资产类型(stock、crypto、forex、bond、futures、coin)以及自定义字段、过滤条件、排序和返回数量
    • 预设与分组工具:screen_stocks、screen_crypto、screen_forex,结合字段集合进行快速筛选
    • Top movers、行业/板块信息:get_top_movers、list_sectors、list_filter_operators
    • 客户端接入示例:可通过 Claude Code 等进行注册与调用( claude mcp add tvscreener -- tvscreener-mcp)
    • 安全与扩展性:基于 MCP 服务器框架,支持多工具暴露,便于扩展
  • 安装步骤

    • 使用 MCP 扩展安装 tvscreener:pip install tvscreener[mcp]
    • 启动 MCP 服务器(可选 CLI 入口,参考仓库文档的命令示例)
    • 详细接入请按客户端 MCP 文档配置对接
  • 服务器配置(供 MCP 客户端初始化读取,不涉及客户端代码) 说明:MCP 客户端在首次接入时需要提供一个包含服务器名称、启动命令与参数的 JSON 配置,以便建立与 MCP 服务器的连接。以下为基于仓库信息的准确示例描述(JSON 结构以文本形式呈现,不是代码块): { "server_name": "tvscreener", "command": "tvscreener-mcp", "args": [] } 注释:

    • server_name: MCP 服务器在客户端的标识名称,建议与项目名称保持一致,便于管理与定位。
    • command: 启动 MCP 服务器的命令。根据仓库的 README,此服务器可通过 tvscreener-mcp 启动(需安装 mcp 扩展)。
    • args: 启动命令的参数列表。当前实现对常用参数未强制要求,保持为空即可,未来可扩展用于端口、日志级别等选项。
  • 基本使用方法(操作指引,简化为可执行步骤)

    1. 客户端准备阶段
      • 安装并配置好 MCP 客户端环境,确保能够通过 JSON-RPC 调用 MCP 工具接口。
    2. 启动 MCP 服务器
      • 按 tvscreener 的文档,使用 tvscreener-mcp 命令启动服务器。
    3. 调用 MCP 工具
      • 通过 MCP 客户端调用工具函数,例如 discover_fields、custom_query、get_top_movers 等,获取字段、筛选结果或自定义查询的响应。
    4. 集成到对话式 AI
      • 将服务器注册到 Claude Code 等平台,使用 claude mcp add tvscreener -- tvscreener-mcp 等命令完成绑定,以实现对话式查询与上下文服务能力。

如需进一步配置,请参考仓库内的 MCP 实现和 Claude/Code 等对 MCP 的接入示例。

服务器信息