Paper Fx

FX 売買 (OANDA) を中核に、テクニカル分析・経済ニュース・株価/指数 (日経平均含む)・企業財務・EDINET 開示・複合スコアリングまで一つの MCP に統合。

ファイル構成

ファイル	役割
oanda_mcp_server.py	MCP エントリ。全ツールを登録
oanda_client.py	OANDA REST API クライアント
indicators.py	テクニカル指標（純Python）とスコアリングロジック
requirements.txt	依存
.env.example	環境変数テンプレ

セットアップ

iPad(ブラウザのみ)で開発する場合は docs/IPAD_DEV.md を参照。Claude Code on the web / GitHub Codespaces / Browser use / Computer use のセットアップ済み。

pip install -r requirements.txt

export OANDA_API_TOKEN="..."
export OANDA_ACCOUNT_ID="101-001-xxxxxxx-001"
export OANDA_ENVIRONMENT="practice"     # デフォルト practice
export NEWSAPI_KEY="..."                 # https://newsapi.org の無料枠
export EDINET_API_KEY="..."              # https://disclosure2.edinet-fsa.go.jp/

Claude Code 登録:

claude mcp add oanda -- python /絶対パス/oanda_mcp_server.py

公開ツール一覧

売買 (OANDA)

• get_price — 通貨ペアの bid/ask
• get_candles — OANDA ローソク足
• get_account — 残高・建玉
• place_order — 成行発注 (SL必須、サイズ自動計算)
• close_position — 指定銘柄の全決済
• kill_switch / reset_kill_switch — 緊急停止

株価・指数 (yfinance, 無料)

• get_index — 指数: ^N225 日経 / ^TPX TOPIX / ^GSPC S&P / ^DJI ダウ / ^IXIC Nasdaq
• get_stock_quote — 銘柄株価: 日本株は 7203.T (トヨタ) 形式、米株は AAPL 等
• get_stock_history — 過去 OHLC

財務・開示

• get_financials — PL/BS/CF (yfinance、日米両対応)
• search_edinet — 有報・四半期報告書・臨時報告書を日付検索

ニュース

• get_news — NewsAPI 経由のキーワード検索 (language='ja' で日本語)

分析・スコアリング

• technical_analysis — FX も株も自動ルーティングで指標一式
• composite_score — テクニカル(自動) + ファンダ + ニュースを加重合成

スコアリングの考え方

technical_score は3コンポーネント（トレンド40% / モメンタム35% / 平均回帰25%）を -100〜+100 に正規化。これだけで戦略になるものではなく、ファンダとニュースは Claude が get_financials と get_news の出力を読んで -100〜+100 の数値を作り、composite_score に渡す ワークフローを想定しています。

例: トヨタの判定

1. technical_analysis("7203.T", granularity="D")
   → テクニカルスコア取得
2. get_financials("7203.T")
   → Claude が「営業利益率改善・FCF黒字・負債健全」と読み、+60 とする
3. get_news("Toyota", language="en", max_results=10)
   → Claude が見出し10件読んで「中立〜やや好材料」と判断、+15
4. composite_score("7203.T", granularity="D",
                   fundamental_score=60, news_sentiment_score=15)
   → 加重合成スコア

完全自動売買に進む前のチェックリスト

1. デモで最低1ヶ月走らせる
2. プロセス監視（落ちたら通知）
3. ネット断/API障害時のフェイルセーフ確認
4. 戦略をバックテスト（このMCPには未実装、要追加）
5. 税務と申告の理解
6. 失っても生活に影響しない金額のみ

既知の限界

• ポジションサイジングは「クォート通貨 ≒ 口座通貨」前提の近似
• yfinance はレート制限あり (短時間に大量呼び出し禁止)
• NewsAPI 無料枠は1日100リクエスト、過去1ヶ月のみ
• EDINET は 書類リストの取得まで。本文の取得・XBRL解析は別途
• スコアは「相対的にどちらに偏っているか」の指標であって、勝率や期待値の保証ではない
• キルスイッチ状態は in-memory（本番なら永続化必須）

拡張ロードマップ

• バックテストツール (backtest_strategy)
• EDINET 書類本文ダウンロードと XBRL パース
• TDnet 適時開示の取得
• 価格ストリーミング (stream_prices via OANDA stream API)
• ポジション履歴の SQLite 永続化
• Discord/Slack 通知連携