TradeOS AI

tradeos-mcp

TradeOS MCP を使うと、TradeOS のトレーディングインテリジェンスを MCP 互換の AI ツールに接続できます。アシスタントは自然言語のプロンプトから、市場の分析、ティッカーの検索、スプレッドの比較、マクロ経済のコンテキストの活用、カスタムトレーディングエージェントの管理を直接行えます。

概要

このリポジトリは、npm で @tradeos/tradeos-mcp を公開します。TradeOS の Streamable HTTP（mcp-call）にツールをプロキシする stdio MCP ブリッジです。次の 2 つの方法で接続できます。

モード	主な用途	認証
HTTP（推奨）	Cursor、Claude Code、ほとんどの MCP クライアント	クライアント内でのブラウザー OAuth
npm stdio	command / stdio のみをサポートするクライアント	TRADEOS_ACCESS_TOKEN 環境変数

本番環境のエンドポイント（どちらのモードでも、最終的にはこのエンドポイントを呼び出します）：

https://ai.tradeos.xyz/api/agent/mcp/mcp-call

製品ドキュメント：TradeOS MCP の統合と使い方

---

前提条件

• Node.js 18+
• MCP API にアクセスできる TradeOS アカウント
• npm stdio の場合：ローカルにインストールして実行できること（Windows に関する注意事項を参照）

---

オプション A — HTTP（推奨）

npm のインストールは不要です。OAuth はクライアントが処理します。

Cursor

ユーザー設定 ~/.cursor/mcp.json（Windows：%USERPROFILE%\.cursor\mcp.json）を編集します。

{
  "mcpServers": {
    "tradeos": {
      "url": "https://ai.tradeos.xyz/api/agent/mcp/mcp-call"
    }
  }
}

保存して Cursor を再起動するか、Settings → MCP で MCP を更新し、プロンプトが表示されたら OAuth を完了します。

Claude Code（プラグイン — 推奨）

tradeos-skills/ に同梱されているプラグインを使用します。

claude --plugin-dir ./tradeos-skills

その後、OAuth を完了して /tradeos:analyze を実行します。プラグインのワークフロー全体（検証、コミュニティマーケットプレイスへの送信）については、tradeos-skills/README.md を参照してください。Claude のプラグインドキュメントに沿っています。

---

オプション B — npm stdio ブリッジ

クライアントがローカルプロセス（command + stdio）を必要とする場合に使用します。

1. ローカルにインストールする

Windows では MCP 内で npx に依存しないでください（キャッシュやパスに問題が発生するため）。固定ディレクトリに一度インストールします。

mkdir -p ~/tradeos-mcp-run   # Windows: mkdir %USERPROFILE%\Downloads\tradeos-mcp-run
cd ~/tradeos-mcp-run         # Windows: cd %USERPROFILE%\Downloads\tradeos-mcp-run
npm install @tradeos/tradeos-mcp

必要に応じて、たとえば @tradeos/[email protected] のようにバージョンを固定できます。

2. TRADEOS_ACCESS_TOKEN を取得する

OAuth ヘルパーを実行します（ブラウザーが開く → TradeOS にログイン → トークンが表示されます）。

# Linux / macOS
npx -y -p @tradeos/tradeos-mcp tradeos-mcp-oauth

# Or subcommand on main bin:
npx -y @tradeos/tradeos-mcp oauth

# Or, from your install directory:
node node_modules/@tradeos/tradeos-mcp/scripts/fetch-token.mjs

Windows（推奨）：

cd /d %USERPROFILE%\Downloads\tradeos-mcp-run
node node_modules\@tradeos\tradeos-mcp\scripts\fetch-token.mjs

表示された JWT（eyJ...）をコピーします。このリポジトリをローカルで開発する場合は、.env にコピーします。

cp .example.env .env
# TRADEOS_ACCESS_TOKEN=eyJ...

パッケージを npm install するだけのエンドユーザーは .env を必要としません。代わりに、MCP クライアントの設定（mcp.json）にトークンを設定してください。

トークンを git にコミットしないでください。

3. Cursor を設定する

{
  "mcpServers": {
    "tradeos-npm": {
      "command": "node",
      "args": [
        "C:/Users/YOU/Downloads/tradeos-mcp-run/node_modules/@tradeos/tradeos-mcp/build/index.js"
      ],
      "env": {
        "TRADEOS_ACCESS_TOKEN": "eyJ..."
      }
    }
  }
}

YOU とパスを、実際のインストール先に置き換えます。JSON ではスラッシュ、またはエスケープしたバックスラッシュを使用してください。

Cursor が node を見つけられない場合は、フルパスを設定します。

"command": "C:/nvm4w/nodejs/node.exe"

Settings → MCP で tradeos-npm を有効にします。ステータスに接続済みと表示され、ツールが一覧表示されていることを確認してください。

4. ターミナルで確認する（任意）

mcp.json 内の環境変数は、シェルには適用されません。同じターミナルセッションでトークンを設定してください。

REM Windows CMD
set TRADEOS_ACCESS_TOKEN=eyJ...
node C:\Users\YOU\Downloads\tradeos-mcp-run\node_modules\@tradeos\tradeos-mcp\build\index.js

# Linux / macOS
export TRADEOS_ACCESS_TOKEN=eyJ...
node ~/tradeos-mcp-run/node_modules/@tradeos/tradeos-mcp/build/index.js

成功時：

[tradeos-mcp] remote: https://ai.tradeos.xyz/api/agent/mcp/mcp-call
[tradeos-mcp] stdio bridge ready

停止するには Ctrl+C を押します。Cursor は独自のプロセスを起動するため、このターミナルを開いたままにする必要はありません。

---

Windows に関する注意事項

1. MCP では npx ではなく、mcp.json にローカルの node とインストール先のパスを指定してください。
2. npm のキャッシュエラーに C:\Program Files\nodejs\node_cache が含まれる場合は、次を一度実行します。

   npm config set cache "%USERPROFILE%\.npm-cache"
   

3. npx @pkg tradeos-mcp-oauth は、Windows では別の bin を実行する場合があります。代わりに次を使用してください。

   npx -y -p @tradeos/tradeos-mcp tradeos-mcp-oauth
   

   または、インストール先ディレクトリから node .../scripts/fetch-token.mjs を実行します。
4. 壊れた npx キャッシュを消去します（先に Cursor を終了してください）。

   rmdir /s /q "%USERPROFILE%\.npm-cache\_npx"
   

---

npm パッケージリファレンス

項目	値
パッケージ	@tradeos/tradeos-mcp
MCP Registry 名	io.github.TradeOS-AI/tradeos-mcp
Bin: MCP ブリッジ	tradeos-mcp
Bin: OAuth トークン	tradeos-mcp-oauth
OAuth サブコマンド	bin tradeos-mcp の oauth

インストール：

npm install @tradeos/tradeos-mcp

---

開発（このリポジトリ）

git clone https://github.com/TradeOS-AI/tradeos-mcp.git
cd tradeos-mcp
npm ci
npm run build
npm run oauth:token    # browser OAuth → prints token (copy into .env if needed)
npm run registry:verify

スクリプト	用途
npm run build	stdio ブリッジを build/ にコンパイルします
npm run oauth:token	ブラウザー OAuth → トークンを出力します
npm run registry:verify	公開前チェック（package.json ↔ server.json）
npm run registry:sync-version <ver>	リリースタグからバージョンを同期します

---

公開（メンテナー向け）

バージョンタグをプッシュすると、.github/workflows/publish-mcp.yml が実行されます：

git tag v1.0.0
git push origin v1.0.0

• 安定版タグ（v1.0.0）は npm の latest と MCP Registry に公開されます。
• プレリリースタグ（v1.0.0-beta.1）は、プレリリースラベルに一致する npm dist-tag（例：beta）で公開されます。
• GitHub Actions シークレット NPM_TOKEN（@tradeos 用の Classic Automation トークン）が必要です。

レジストリ API で確認します：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.TradeOS-AI/tradeos-mcp"

---

トラブルシューティング

症状	考えられる原因	対処法
TRADEOS_ACCESS_TOKEN is required	環境変数または mcp.json にトークンが設定されていない	OAuth ヘルパーを実行し、MCP 設定の env を設定します
接続時に unauthorized が表示される	トークンの期限切れまたは無効	OAuth を再実行し、新しい JWT を貼り付けます（Bearer プレフィックスなし）
EPERM / node_cache	npm キャッシュが Program Files 配下にある	npm config set cache "%USERPROFILE%\.npm-cache"
TAR_ENTRY_ERROR / 'tradeos-mcp' is not recognized	Windows で npx が失敗した	ローカルにインストールし、mcp.json に node のパスを設定します
node_modules/... の MODULE_NOT_FOUND	間違ったディレクトリからスクリプトを実行した	インストール先ディレクトリに cd するか、絶対パスを使用します
ターミナルではトークンが機能するが、Cursor では機能しない	mcp.json のパスまたはトークンが一致していない	パスを一致させ、Cursor を再起動するか MCP を更新します
MCP は接続するがツールが表示されない	有効になっているサーバーが間違っている	動作しない localhost エントリーを無効にし、本番 HTTP URL または動作する tradeos-npm を使用します

---

関連項目

• tradeos-skills/ — Claude Code プラグイン + 分析スキル
• server.json — MCP Registry マニフェスト
• TradeOS MCP よくある質問（GitBook）