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 接口调用这些工具。

配置 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 下达订单。

祝交易愉快！🚀