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服务器公开了以下工具，可直接从MCP界面调用：

• 🛒 buyorder：用于下单购买股票。
• 🛍️ sellorder：用于下单出售股票。

高级用法

要使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通过自然语言下单交易。

祝您交易愉快！🚀