XCREENER

@xcreener/mcp

XCREENER の XQL スクリーナー API 用のローカル stdio MCP ブリッジです。Claude Desktop、Cursor、Windsurf、その他の stdio MCP クライアントから、XQL クエリの検証、説明、実行ができます。

XCREENER について

XCREENER は、Crypto、Forex、Indices、Commodities、Metals を同時にスキャンするマーケットスクリーナーです。チャートを一つずつ確認する必要はありません。既製のスクリーナーを使う初心者トレーダーから、XCREENER Query Language（XQL）で独自の条件を記述し、REST API または MCP 経由ですぐに実行できる開発者や AI エージェントまで、幅広いユーザー向けに構築されています。詳しくは xcreener.com をご覧ください。

この MCP サーバーの機能

このパッケージは、XCREENER の XQL API 専用のローカル stdio ブリッジです。xql_validate、xql_explain、xql_run、xql_nl_reference を MCP ツールとして公開するため、stdio MCP クライアントから、HTTP 通信のためのコードを自分で書かずに、ライブ市場データに対する XQL スクリーニングの確認と実行ができます。

インストール

Claude Desktop（.mcpb）

このリポジトリの Releases ページから最新の xcreener.mcpb をダウンロードし、ダブルクリックしてインストールします。同じダイアログ内で、マスクされた入力欄に API キーを入力するよう Desktop から求められます。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

次に、XCREENER_API_KEY をクライアントの環境変数に設定し、クライアントから node dist/index.js を指定します。

設定

変数	必須	説明
XCREENER_API_KEY	はい	xcreener.com/account/api-key から取得する XCREENER API キーです。

キーは必要になった時点で検証されます。無効なキーやキーが指定されていない場合でもサーバーの起動は妨げられず、ツールを初めて呼び出したときに 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に基づく集計（各通貨について、他の7通貨に対する平均変動率を算出）：

順位	通貨	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)を下回る水準。ATR(14)の約3倍
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 を参照してください。