使用说明
🌟 Currency Analyze MCP
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 |
USD/JPY総合分析とトレード推奨 |
get_current_rate |
現在の為替レート取得 |
get_technical_indicators |
テクニカル指標計算 |
get_market_summary |
市場サマリー取得 |
get_cache_stats |
キャッシュ統計表示 |
clear_cache |
キャッシュクリア |
consult_trading |
NEW! プロ級トレード相談 |
使用例
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: GitHub Issues
- Author: @jey3dayo
Made with ❤️ for FX traders and developers
