Nuvama MCP

🚀 Nuvama - MCP 交易系統

該項目將Nuvama的交易平臺與Claude AI相結合，藉助MCP框架實現二者的直接交互。用戶能夠通過Claude AI直接訪問Nuvama的交易平臺，為交易操作帶來極大便利。

🚀 快速開始

本項目將Nuvama交易平臺與Claude AI集成，通過MCP框架，讓你能借助Claude AI自然語言能力，輕鬆實現交易操作。按以下步驟操作，即可快速開啟交易之旅。

✨ 主要特性

• 📈 支持購買和出售股票訂單，滿足多樣化交易需求。
• 📊 可從API獲取並顯示持倉信息，讓您即時掌握資產狀況。
• ⚡ 快速MCP服務器集成，使您能輕鬆訪問各類交易工具。

📦 安裝指南

先決條件

• 🐍 系統中需已安裝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服務器公開了以下工具，可直接從MCP界面調用：

• 🛒 buyorder：下單購買。
• 🛍️ sellorder：下單出售。

高級用法

配置Claude進行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通過自然語言下單交易。

📚 詳細文檔

項目結構

• index.py：包含與交易API交互的核心邏輯。
• trade_mcp_server.py：實現FastMCP服務器，將交易功能作為工具公開。
• .gitignore：指定Git應忽略的文件和目錄。

祝您交易愉快！🚀