Nuvama MCP

🚀 Nuvama - MCP取引システム 🛠️

このプロジェクトは、Nuvamaの取引プラットフォームとClaude AIを統合し、MCPフレームワークを通じて直接的なやり取りを実現します。これにより、Claude AIを通じてNuvamaの取引プラットフォームに直接アクセスすることができます。

✨ 主な機能

• 📈 株式の買い注文と売り注文
• 📊 APIから保有情報を取得して表示
• ⚡ 高速なMCPサーバー統合で、簡単にツールにアクセス

📂 プロジェクト構成

• 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
   

💻 使用例

基本的な使用法

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

• 🛒 buyorder：買い注文を出す
• 🛍️ sellorder：売り注文を出す

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

高度な使用法

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から直接取引注文を出すことができます。

最後に、楽しい取引を！🚀