XCREENER

@xcreener/mcp

面向 XCREENER XQL 筛选器 API 的本地 stdio MCP 桥接服务——可从 Claude Desktop、Cursor、Windsurf 或任何 stdio MCP 客户端验证、解释和运行 XQL 查询。

关于 XCREENER

XCREENER 是一个市场筛选器，可同时扫描加密货币、外汇、指数、大宗商品和金属，省去逐一查看图表的麻烦。它既为初学者交易者提供现成的筛选器，也面向开发者和 AI Agent；后者可以用 XCREENER 查询语言（XQL）表达自定义条件，并通过 REST API 或 MCP 即时运行。了解更多信息，请访问 xcreener.com。

此 MCP 服务的功能

此软件包是专门连接 XCREENER XQL API 的本地 stdio 桥接服务。它将 xql_validate、xql_explain、xql_run 和 xql_nl_reference 作为 MCP 工具提供，因此任何 stdio MCP 客户端都可以针对实时市场数据检查并执行 XQL 筛选器，无需编写任何 HTTP 胶水代码。

安装

Claude Desktop（.mcpb）

从此仓库的 Releases 页面下载最新的 xcreener.mcpb，然后双击安装——Desktop 会在同一个对话框中通过遮蔽输入框询问你的 API 密钥。无需手动编辑 JSON，也无需单独安装 Node。

其他 MCP 客户端（npx）

将以下内容添加到客户端的 MCP 服务配置中（例如 Cursor、Windsurf、Claude Code）：

{
  "mcpServers": {
    "xcreener": {
      "command": "npx",
      "args": ["-y", "@xcreener/mcp"],
      "env": { "XCREENER_API_KEY": "your-api-key" }
    }
  }
}

从源代码安装

git clone https://github.com/xcreener/xcreener-mcp.git
cd xcreener-mcp
npm install
npm run build

然后将客户端指向 node dist/index.js，并在其环境中设置 XCREENER_API_KEY。

配置

变量	必填	说明
XCREENER_API_KEY	是	你的 XCREENER API 密钥，可从 xcreener.com/account/api-key 获取。

密钥采用延迟检查——无效或缺失的密钥不会阻止服务启动，只会在首次调用工具时显示为 auth 错误。

可用工具

名称	类型	说明
xql_validate	工具	通过解析和规划 XQL 查询文本来验证查询，但不会针对实时数据执行。
xql_explain	工具	解析并规划 XQL 查询，返回其执行计划和易于理解的说明。
xql_run	工具	针对实时市场数据解析、规划并执行 XQL 查询，返回匹配的交易品种。
xql_nl_reference	工具	将自然语言交易短语映射到 XQL 语法的参考文档。

示例会话

在底层，助手会调用 xql_nl_reference 工具，将你用英文提出的请求转换为 XQL 查询，然后调用 xql_validate/xql_run——你看到的只是面向用户的对话。以下是几个真实示例：

多市场筛选

**你：**检查所有市场，看看目前有哪些品种处于超卖状态

XCREENER 运行（对每个市场使用相同查询——CRYPTO、FOREX、INDICES、METALS、COMMODITIES）：

market = "CRYPTO"
timeframe = h1
columns = [rsi(14)]
sort = rsi(14) asc
rsi(14) < 30

**XCREENER：**所有市场的超卖品种（RSI(14) < 30，小时线）：

市场	代码	RSI(14)
加密货币	BTCUSDT	26.3
加密货币	ETHUSDT	27.5
加密货币	XRPUSDT	28.0
大宗商品	WHEATUSD	21.0
大宗商品	CORNUSD	22.6

外汇、指数和金属市场没有符合条件的超卖品种。

单一市场快照

**你：**能告诉我金属市场的表现吗？

XCREENER 运行：

market = "METALS"
timeframe = h1
let uptrend = close > sma(50)
columns = [close, roc(1), rsi(14), uptrend]
sort = roc(1) desc
close > 0

**XCREENER：**金属市场小时线快照：

代码	收盘价	1 小时 ROC	RSI(14)	趋势（相对于 SMA50）
XPTUSD（铂金）	1,637.98	+0.03%	54.8	上升趋势
XAGUSD（白银）	57.48	+0.02%	38.6	下降趋势
XAUUSD（黄金）	4,043.69	+0.01%	41.0	下降趋势

总体而言，市场相当平静，没有明显的超卖或超买（RSI 均为 38–55）。铂金表现最强——处于上升趋势，动能也最强；而黄金和白银则在其 50 小时均线下方徘徊。

跨货币对汇总分析

**你：**哪种货币最弱，哪种最强？

XCREENER 运行：

market = "FOREX"
timeframe = h1
columns = [close, roc(1)]
sort = roc(1) desc
close > 0

**XCREENER：**根据所有 28 个货币对的 1 小时 ROC（汇总每种货币相对于其他七种货币的平均涨跌幅）：

排名	货币	平均 1 小时强度
1（最强）	CHF	+0.0414%
2	JPY	+0.0184%
...
8（最弱）	USD	-0.0421%

最强：CHF——本小时兑其他所有主要货币均上涨。最弱：USD——兑 EUR、GBP、AUD、JPY 和 CHF 等货币普遍走弱。

可执行的交易计划

**你：**NZD 看起来是本周最强的货币——根据这一点，我应该做多哪个货币对？止损和止盈设在哪些水平比较合理？

XCREENER 运行：

market = "FOREX"
timeframe = h1
symbols = ["NZDUSD"]
columns = [close, atr(14), sma(50), highest(high, 20), lowest(low, 20), w::lowest(low, 52), rsi(14)]
close > 0

**XCREENER：**交易设想：做多 NZDUSD——这是多周期信号最一致的选择：NZD 是本周强度排名第 2 的货币，日线信号不冲突，小时线显示上升趋势（收盘价 0.5881 > SMA(50) 0.5846），动能看涨但尚未超买（RSI(14) 60.8）。

	价位	理由
入场	~0.5881	当前价格
止损	0.5845	低于 20 小时波段低点和 h1 SMA(50)；约为 3× ATR(14)
TP1	0.5940	~1.6:1 风险回报比，部分平仓
TP2	0.6093	周线 52 周高点，~5.9:1 风险回报比

不构成财务建议——这是基于获取的数据进行的技术分析；入场前请结合执行和点差成本进行确认。

开发

npm run dev         # tsup --watch
npm run build        # build dist/index.js
npm run build:mcpb   # build + pack dist-mcpb/xcreener.mcpb
npm run lint
npm run typecheck

构建会通过 tsup 生成一个包含所有内联依赖的 ESM 文件（dist/index.js），因此 npm 包和 .mcpb 包均无需附带 node_modules。

许可证

MIT — 详见 LICENSE。