🚀 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应忽略的文件和目录。

祝您交易愉快！🚀