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: 启动命令的参数列表。当前实现对常用参数未强制要求,保持为空即可,未来可扩展用于端口、日志级别等选项。
-
基本使用方法(操作指引,简化为可执行步骤)
- 客户端准备阶段
- 安装并配置好 MCP 客户端环境,确保能够通过 JSON-RPC 调用 MCP 工具接口。
- 启动 MCP 服务器
- 按 tvscreener 的文档,使用 tvscreener-mcp 命令启动服务器。
- 调用 MCP 工具
- 通过 MCP 客户端调用工具函数,例如 discover_fields、custom_query、get_top_movers 等,获取字段、筛选结果或自定义查询的响应。
- 集成到对话式 AI
- 将服务器注册到 Claude Code 等平台,使用 claude mcp add tvscreener -- tvscreener-mcp 等命令完成绑定,以实现对话式查询与上下文服务能力。
- 客户端准备阶段
如需进一步配置,请参考仓库内的 MCP 实现和 Claude/Code 等对 MCP 的接入示例。