Nuvama-MCP 🛠️

Nuvama-MCP 🛠️

このプロジェクトは、MCP フレームワークを使用してNuvamaの取引プラットフォームとClaude AIを連携し、Claude AIを通じてNuvamaの取引プラットフォームと直接やり取りできるようにします。

機能 ✨

• 📈 株式の買い注文と売り注文を発注します。
• 📊 APIから保有銘柄を取得して表示します。
• ⚡ ツールに簡単にアクセスできるFastMCPサーバー連携。

プロジェクト構成 📂

• index.py: 取引APIとやり取りするためのコアロジックが含まれています。
• trade_mcp_server.py: 取引機能をツールとして公開するFastMCPサーバーを実装します。
• .gitignore: Gitで無視するファイルとディレクトリを指定します。

前提条件 ✅

• 🐍 システムにPython 3.xがインストールされていること。
• 📦 必要なPythonパッケージ（例: FastMCP、APIConnect）がインストールされていること。
• 🔑 API認証情報（APIキー、シークレット、リクエストID）。
• 📄 株式シンボルと取引所の詳細を含むCSVファイル。

セットアップ手順 🛠️

1. リポジトリをローカルマシンにクローンします。

2. 必要なPythonパッケージをインストールします。

   pip install -r requirements.txt
   

3. index.py の以下のプレースホルダーを更新します。

   • api_key: APIキー。
   • api_secret: APIシークレット。
   • request_id: リクエストID。
   • settings_file: 設定ファイルのパス。
   • csv_file_path: 銘柄CSVファイルのパス。

4. FastMCPサーバーを起動します。

   uv run trade_mcp_server.py
   

MCPツールの使用 🛠️

FastMCPサーバーは以下のツールを公開します。

• 🛒 buyorder: 買い注文を発注します。
• 🛍️ sellorder: 売り注文を発注します。

これらのツールはMCPインターフェースから直接呼び出せます。

MCP連携用のClaudeの設定 🤖

ClaudeがMCPツールを認識できるようにするには、適切なディレクトリに設定ファイル（例: claude_config.json）を作成し、以下の内容を追加します。

{
    "mcpServers": {
        "trade": {
            "command": "<path_to_uv_executable>",
            "args": [
                "--directory",
                "<path_to_trade_directory>",
                "run",
                "trade_server.py"
            ]
        }
    }
}

<path_to_uv_executable> を uv.exe ファイルのパスに、<path_to_trade_directory> をプロジェクトディレクトリのパスに置き換えます。この設定ファイルをClaudeが検出できる場所に配置してください。

この設定により、ClaudeがMCPツールとやり取りできるようになり、自然言語を使ってClaudeから直接注文を発注できます。

取引をお楽しみください！🚀