Fyers Mcp Server

Fyers MCP サーバー

Fyers API v3 向け MCP（Model Context Protocol）サーバー。OAuth 認証を自動化します

安全で自動化された認証フローを通じて、Claude Desktop から Fyers の取引プラットフォームを利用できる包括的な MCP サーバーです。ポートフォリオ管理、注文の発注、リアルタイムの市場データなど、主要な取引操作に対応しています。

🎬 デモ

✨ 特長

🔐 スマート認証

• ブラウザー処理を自動化したワンクリック OAuth フロー
• .env ファイルへのトークンの永続保存
• セッション管理による自動更新機能

📊 充実した取引ツールキット

• ポートフォリオ管理：保有資産、ポジション、資金、プロフィール
• 注文管理：注文の発注、変更、キャンセル
• 市場データ：複数の銘柄のリアルタイム相場
• 注文履歴：注文および取引履歴の全記録

🚀 本番環境に対応

• 詳細なエラーメッセージを含む完全なエラー処理
• パラメーター検証による型安全性
• デバッグ用の包括的なログ記録
• 簡単な設定で利用できるClaude Desktop 連携

🚀 クイックスタート

前提条件

• Python 3.10 以降
• Claude Desktop がインストールされていること
• API アクセスが有効な Fyers 取引口座

1. インストール

# Clone the repository
git clone https://github.com/quantabox/fyers-mcp-server.git
cd fyers-mcp-server

# Install dependencies using uv (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

# Or install with pip
pip install .

2. Fyers API の認証情報を取得

1. Fyers API アプリを作成する：

   • Fyers API ダッシュボード にアクセスします
   • リダイレクト URI http://localhost:8080/ を指定して、新しいアプリを作成します
   • App ID と Secret Key を控えておきます

2. 環境を設定する：

   cp .env.example .env
   

   .env ファイルを編集します：

   FYERS_CLIENT_ID=YOUR_APP_ID-100     # e.g., ABC123XYZ-100
   FYERS_SECRET_KEY=YOUR_SECRET_KEY    # Secret from Fyers app
   FYERS_REDIRECT_URI=http://localhost:8080/
   

3. Claude Desktop を設定する

Claude Desktop の設定ファイルに以下を追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fyers-mcp-server": {
      "command": "uv",
      "args": [
        "run", 
        "--directory",
        "/path/to/fyers-mcp-server",
        "python",
        "fyers_mcp_complete.py"
      ],
      "env": {
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}

4. 初回起動

1. Claude Desktop を再起動します
2. 認証します：Claude で authenticate と入力します
3. ブラウザーが開きます → Fyers にログインします → トークンが自動的に取得されます
4. 取引を開始します：11 個のツールがすべて利用可能になります

🛠️ 利用可能なツール

認証とプロフィール

• authenticate() - ワンクリック OAuth 認証
• check_auth_status() - 現在の認証状態を確認
• get_profile() - ユーザープロフィール情報

ポートフォリオと資金

• get_funds() - 口座残高と証拠金の詳細
• get_holdings() - 損益情報付きのポートフォリオ保有資産
• get_positions() - 現在の取引ポジション

注文と取引

• place_order(symbol, quantity, order_type, side, ...) - 新しい注文を発注
• modify_order(order_id, quantity, limit_price, ...) - 既存の注文を変更
• cancel_order(order_id) - 保留中の注文をキャンセル
• get_orders() - 注文履歴とステータス

市場データ

• get_quotes(symbols) - 複数の銘柄のリアルタイム相場

📖 使用例

ポートフォリオ分析

# Check account balance
get_funds()

# View all holdings with P&L
get_holdings()

# Check current positions
get_positions()

注文管理

# Place a market order
place_order("NSE:SBIN-EQ", 10, "MARKET", "BUY")

# Place a limit order
place_order("NSE:RELIANCE-EQ", 5, "LIMIT", "BUY", limit_price=2500)

# Modify an order
modify_order("ORDER_ID", quantity=15, limit_price=2550)

# Cancel an order
cancel_order("ORDER_ID")

市場データ

# Get live quotes
get_quotes("NSE:SBIN-EQ,NSE:RELIANCE-EQ,NSE:TCS-EQ")

🔧 設定オプション

注文タイプ

• MARKET - 成行注文（即時執行）
• LIMIT - 指値注文（指定価格で執行）
• STOP - ストップロス注文
• STOPLIMIT - ストップリミット注文

商品タイプ

• MARGIN - 証拠金取引（レバレッジを利用した日中取引）
• CNC - キャッシュ・アンド・キャリー（受渡し）
• INTRADAY - 日中取引
• BO - ブラケット注文
• CO - カバー注文

有効期間のオプション

• DAY - 当日の取引終了まで有効
• IOC - 即時約定またはキャンセル
• GTD - 指定日まで有効

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

よくある問題

1. 認証に失敗する

# Check credentials in .env file
cat .env | grep FYERS

# Verify app configuration at https://myapi.fyers.in/dashboard/

2. Claude Desktop の接続に関する問題

# Test MCP server directly
cd /path/to/fyers-mcp-server
uv run python fyers_mcp_complete.py

# Check Claude Desktop logs (macOS)
tail -f ~/Library/Logs/Claude/mcp.log

3. 注文の発注エラー

• 銘柄コードの形式を確認してください：株式の場合は NSE:SYMBOL-EQ
• 取引時間を確認してください（IST の午前 9:15 ～ 午後 3:30）
• 資金／証拠金が十分にあることを確認してください

デバッグモード

詳細なログを有効にします：

export LOG_LEVEL=DEBUG
uv run python fyers_mcp_complete.py

🚧 開発

プロジェクト構成

fyers-mcp-server/
├── fyers_mcp_complete.py    # Main MCP server
├── pyproject.toml          # Dependencies
├── .env.example           # Environment template
├── claude_config.json     # Claude Desktop config
└── README.md             # This file

新機能の追加

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/new-tool
3. MCP ツールを追加します：@mcp.tool() デコレーターを使用します
4. Claude Desktop でテストします
5. プルリクエストを送信します

テスト

# Install development dependencies
uv sync --dev

# Run tests
uv run pytest

# Type checking
uv run mypy fyers_mcp_complete.py

📋 API リファレンス

認証フロー

graph TD
    A[Claude: authenticate] --> B[Generate Auth URL]
    B --> C[Open Browser]
    C --> D[User Login]
    D --> E[Auth Code Capture]
    E --> F[Exchange for Token]
    F --> G[Store in .env]
    G --> H[Ready for Trading]

エラー処理

すべての関数は、標準化された応答を返します：

• ✅ 成功：関連データを含む明確な確認メッセージ
• ❌ エラー：トラブルシューティングのヒントを含む詳細なエラーメッセージ

🤝 貢献

皆さんからの貢献を歓迎します！詳しくは、貢献ガイドラインをご覧ください。

貢献できる分野

• WebSocket によるリアルタイムデータのストリーミング
• 高度な注文タイプ（OCO、アイスバーグ注文）
• ポートフォリオの分析とレポート作成
• オプションチェーン分析ツール
• リスク管理機能

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細はLICENSEファイルをご覧ください。

⚠️ 免責事項

このソフトウェアは、教育および開発を目的としています。取引には金銭的なリスクが伴います。取引の判断はユーザー自身の責任で行い、実際の取引を始める前に、デモ環境で十分にテストしてください。

🔗 リンク

• Fyers API ドキュメント
• MCP プロトコル仕様
• Claude Desktop
• 問題とサポート

📊 ステータス

• 現在のバージョン：1.0.0
• API 互換性：Fyers API v3.1.7
• Python サポート：3.10+
• 利用可能なツール：11/11 ✅
• 本番環境対応：はい ✅

---

取引コミュニティのために ❤️ を込めて作成
_{Claude のインテリジェンスでアルゴリズム取引を実現}