使用说明

项目简介

Wealthy MCP 服务器是 Wealthy 交易平台的官方后端实现，遵循 Model Context Protocol (MCP)。它允许支持 MCP 的 LLM 客户端（如 Claude, Cursor）通过一个标准化的协议与 Wealthy 交易平台进行交互。这意味着您可以通过自然语言，在 LLM 客户端中直接查询您的交易数据、获取市场信息甚至进行下单操作。

主要功能点

本服务器提供了以下核心功能，允许 LLM 客户端访问 Wealthy 交易平台的数据和能力：

获取市场价格: 查询指定交易符号（股票等）的当前市场价格。
查看持仓: 显示您账户中当前的投资组合持有详情。
显示未平仓位: 查看您所有未完成的交易订单（开仓）。
列出所有订单: 查询您的全部订单记录，包括已开仓、已执行和已取消的订单。
获取交易建议: 提供潜在的交易机会和市场分析洞察。
查询证券详情: 获取特定证券或股票的详细信息。
下新订单: 通过 LLM 客户端直接提交买入或卖出订单。

安装步骤

您可以选择从源代码安装或下载预编译的二进制文件：

从源代码安装:

确保您已安装 Go 1.23 或更高版本。

打开终端或命令行，运行以下命令：

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

这会将可执行文件安装到您的 Go bin 目录。

下载预编译二进制文件:
- 访问项目的 releases 页面。
- 下载适用于您操作系统的最新版本二进制文件。
- 解压下载的文件，并将可执行文件放置在您系统 PATH 环境变量包含的目录中，或者记录下其完整路径。
- 如果您使用的是 Mac，可能需要运行以下命令赋予执行权限并移除隔离属性：
```
chmod +x /path/to/wealthy-mcp-macos-arm64-<version>
xattr -d com.apple.quarantine /path/to/wealthy-mcp-macos-arm64-<version>
```
  （请将 '/path/to/' 替换为您实际的文件路径，'<version>' 替换为下载的版本号）

服务器配置 (供 MCP 客户端使用)

Wealthy MCP 服务器需要通过 MCP 客户端进行配置和启动。配置信息通常保存在 MCP 客户端的特定配置文件中（例如 Cursor 的 '.cursor/mcp.json' 或 Claude 的 'claude_desktop_config.json'）。

您需要在客户端的配置文件中，在 '"mcpServers"' 部分添加 Wealthy MCP 服务器的配置。配置结构如下：

{
  "mcpServers": {
    "wealthy-mcp": {
      "command": "填写 Wealthy MCP 可执行文件的完整路径或名称（如果已在 PATH 中）",
      "args": ["可选参数，例如指定监听地址和端口，如 addr=localhost:8006"]
    }
    // ... 可能有其他 MCP 服务器配置 ...
  }
}

'"wealthy-mcp"': 这是服务器的名称，LLM 客户端会使用此名称来引用该服务器。
'"command"': 指定如何启动 Wealthy MCP 服务器。填写您安装或下载的可执行文件的完整路径。如果可执行文件所在的目录已添加到系统 PATH 中，则只需填写可执行文件的名称（例如 'wealthy-mcp'）。
'"args"': 这是一个可选参数列表，用于向 Wealthy MCP 服务器传递启动参数。常用的参数是 'addr=<host>:<port>'，用于指定服务器监听的地址和端口，例如 '"args": ["addr=localhost:8006"]'。

配置步骤概要:

找到您的 MCP 客户端（如 Cursor 或 Claude）的配置文件。
编辑该文件，找到或创建 '"mcpServers"' 部分。
在 '"mcpServers"' 下添加 '"wealthy-mcp"' 的配置项，设置正确的 '"command"'。
（可选）如果需要使用自定义地址/端口，添加 '"args"' 参数。
保存配置文件。
重启您的 MCP 客户端。
首次启动时，服务器可能会在浏览器中打开 Wealthy 登录页面，请按照提示完成认证。
认证成功后，返回您的 MCP 客户端即可开始使用。

基本使用方法

配置并启动服务器后，您可以在支持 MCP 的 LLM 客户端中通过自然语言与 Wealthy MCP 服务器交互。客户端会自动识别服务器提供的工具和功能。

例如，您可以在聊天界面中输入以下问题或指令：

"RELIANCE 的价格是多少？" (使用 'get_price' 工具)
"显示我的当前持仓" (使用 'get_holdings' 工具)
"我想以市价买入 100 股 TATAMOTORS" (使用 'place_order' 工具)
"查看我的订单记录" (使用 'get_order_book' 工具)
"今天的交易建议有哪些？" (使用 'get_trade_ideas' 工具)

客户端会将您的自然语言请求转换为 MCP 格式的工具调用或 Prompt 请求发送给 Wealthy MCP 服务器，服务器处理后将结果返回给客户端。

关键词