Currency Analyze MCP

🌟 Currency Analyze MCP

](https://nodejs.org/)   

USD/JPY為替ペアのリアルタイム分析と高度なテクニカル分析を提供するMCP（Model Context Protocol）サーバー

🌟 特徴

• ✨ リアルタイム為替レート: Alpha Vantage API連携
• 📊 テクニカル分析: SMA, EMA, RSI, MACD, ボリンジャーバンド
• 🎯 トレード相談AI: エントリー/エグジット戦略、リスク管理
• ⏰ マルチタイムフレーム: 15分/1時間/4時間/日足
• 💾 メモリキャッシュ: API呼び出しを60-80%削減
• 🤖 Claude Desktop統合: シームレスなAI連携

📦 必要要件

• Node.js v22.19.0以上
• pnpm v9.0以上
• Alpha Vantage APIキー (無料取得)

🚀 クイックスタート

# インストール
git clone https://github.com/jey3dayo/currency-analyze-mcp.git
cd currency-analyze-mcp
pnpm install
pnpm build

# 環境変数設定
cp .env.example .env
echo "ALPHA_VANTAGE_API_KEY=your_api_key" > .env

# Claude Desktop設定
# ~/Library/Application Support/Claude/claude_desktop_config.json を編集

{
  "mcpServers": {
    "currency-analyze": {
      "command": "node",
      "args": ["/path/to/currency-analyze-mcp/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_api_key"
      }
    }
  }
}

🛠️ 利用可能なツール

使用例

analyze_usdjpy

// リクエスト
{ "timeframe": "1h" }

// レスポンス
{
  "summary": "USD/JPYは149.72円、横ばい傾向。買い推奨。",
  "currentStatus": { "price": "149.72円", "trend": "横ばい" },
  "recommendation": { "action": "買い推奨", "riskLevel": "medium" }
}

consult_trading (NEW!)

// リクエスト
{
  "position": "none",
  "currentPrice": 148.2,
  "riskTolerance": "standard",
  "timeframe": "1h"
}

// レスポンス: エントリー戦略、リスク管理、OCO注文設計を提供

詳細は APIリファレンス を参照してください。

📊 テクニカル指標

• 移動平均: SMA(20,50), EMA(20)
• オシレーター: RSI(14)
• トレンド: MACD(12,26,9)
• ボラティリティ: ボリンジャーバンド(20,2σ)

💾 キャッシュシステム

graph LR
    Request --> L1[Memory Cache]
    L1 -->|Hit| Response
    L1 -->|Miss| API[Alpha Vantage]
    API --> L1
    API --> Response

詳細: キャッシュシステム

🔧 開発

pnpm dev        # 開発サーバー
pnpm test       # テスト実行
pnpm build      # ビルド
pnpm lint       # リント

📚 ドキュメント

• APIリファレンス - 全ツール詳細仕様
• トラブルシューティング - 問題解決
• 開発者ガイド - 開発環境構築
• キャッシュシステム - メモリキャッシュ
• トレーディングガイド - FXトレード機能

❓ トラブルシューティング

# キャッシュクリア (MCP再起動)
# Claude Desktopを再起動

# ログ確認
tail -f ~/Library/Logs/Claude/mcp-server-currency-analyze.log

詳細: トラブルシューティングガイド

📄 ライセンス

MIT License - LICENSE

📧 サポート

• Issues:
• Author: @jey3dayo

Made with ❤️ for FX traders and developers