Wealthy MCP(Model Context Protocol) Server

Wealthy MCP（Model Context Protocol）服务

此仓库包含 Wealthy 官方 MCP 服务，可帮助用户使用交易平台功能。

前提条件

• Wealthy 交易账户 - https://www.wealthy.in/broking
• MCP 客户端 - Claude 或 Cursor

开始使用

你可以从源代码安装，也可以下载预构建的制品：

选项 1：从源代码安装

• 使用 golang 安装（go 1.23 或更高版本）：

  go install github.com/wealthy/wealthy-mcp/cmd/wealthy-mcp@latest
  

选项 2：下载预构建的制品

• 访问我们的发布页面，下载适用于你平台的最新预构建二进制文件
• 解压下载的归档文件，并将可执行文件放入系统 PATH 中的目录
• 运行以下命令以在 mac 上授予权限：

chmod +x wealthy-mcp-macos-arm64-<version>
xattr -d com.apple.quarantine wealthy-mcp-macos-arm64-<version>

MCP 配置

若要配置 MCP（Multi-Cursor Protocol）服务，请根据你的客户端创建或更新相应的配置文件：

Cursor

在主目录中创建或更新 .cursor/mcp.json：

{
    "mcpServers": {
      "wealthy-mcp": {
        "command": "<path to downloaded/installed binary>"
      }
    }
}

Claude

创建或更新 claude_desktop_config.json：

{
    "mcpServers": {
      "wealthy-mcp": {
        "command": "<path to downloaded/installed binary>"
      }
    }
}

若要使用自定义端口，请添加 args 参数：

{
    "mcpServers": {
      "wealthy-mcp": {
        "command": "<path to downloaded/installed binary>",
        "args": ["addr=localhost:8006"]
      }
    }
}

• 重启 MCP 客户端（Claude/Cursor）
• Wealthy 登录页面将打开，请输入你的凭据
• 成功登录后，返回 MCP 客户端
• 现在可以开始智能交易了！🎉

用法

以下是可用的查询类型及其用途：

查询类型	用途
get_user_margin	获取用户保证金信息
get_price	获取指定交易代码的当前市场价格
get_holdings	显示你当前的投资组合持仓及其详情
get_positions	显示你未平仓的交易头寸
get_order_book	列出你的所有订单（未完成、已执行和已取消）
get_trade_ideas	提供交易建议和市场见解
get_security_info	获取特定证券/股票的详细信息
place_order	根据指定参数下达新的买入/卖出订单
create_watchlist	创建新的证券自选列表
get_watchlist	获取现有自选列表
update_watchlist	使用新证券更新现有自选列表
search	搜索并查找证券代码
research	获取交易思路和研究信息
reports_tool	生成各类报告（持仓/头寸/订单簿）

你可以通过 Claude/Cursor 使用自然语言与这些查询交互。例如：

• “RELIANCE 的价格是多少？”
• “显示我当前的持仓”
• “我想以市价买入 100 股 TATAMOTORS”
• “为科技股创建一个自选列表”
• “搜索与可再生能源相关的股票”
• “获取银行业的研究建议”

路线图

• 实时市场数据集成

  • 实现 WebSocket 连接，以实时推送价格
  • 添加对订阅多个代码的支持
  • 改进价格数据的格式和显示

• 价格提醒系统

  • 支持通过自然语言设置价格提醒
  • 支持多种提醒条件（高于/低于/穿越）
  • 在聊天中实现提醒通知
  • 添加提醒管理功能（列出/修改/删除提醒）

• 高级功能

  • 提供实时更新的投资组合分析
  • 提供实时更新的自定义自选列表
  • 支持高级提醒条件（技术指标）
  • 改进报告和分析功能

• 平台增强

  • 高级订单类型
  • 自动化交易策略
  • 支持其他金融产品

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

交易免责声明

本软件仅供参考，不应被视为投资建议。金融工具交易风险很高，包括损失部分或全部投资金额的风险。交易前，请仔细考虑您的投资目标、经验水平和风险承受能力。

法律声明

使用本软件即表示您确认：

1. 您了解与交易相关的风险
2. 您会在需要时寻求专业的财务建议
3. 作者和贡献者不对任何交易损失承担责任
4. 您会遵守所有适用的金融法规

支持

如需支持，请在 GitHub 仓库中提交 issue、联系维护者，或发送邮件至 [email protected] 联系 Parth。