项目简介
Wealthy MCP Server 是一个基于 Model Context Protocol (MCP) 实现的应用后端,旨在将 Wealthy 交易平台的各项功能和数据通过标准化的方式暴露给大型语言模型 (LLM) 客户端(如 Claude, Cursor),使LLM能够理解和执行与交易相关的任务。
主要功能点
- 交易操作: 支持通过LLM指令进行证券的买入和卖出。
- 账户信息查询: 允许LLM查询用户的当前持仓 (Holdings)、订单列表 (Order Book) 和头寸 (Positions)。
- 市场数据获取: 提供查询特定证券的市场价格和基本信息的能力。
- 交易策略建议: 可以获取平台提供的交易想法或策略建议。
- 身份认证: 集成Wealthy账户的浏览器登录认证流程。
- MCP协议支持: 实现MCP的Tool和Prompt机制,通过JSON-RPC与客户端通信,支持Stdio和SSE等传输协议。
安装步骤
Wealthy MCP Server 使用 Go 语言开发,安装Go 1.23或更高版本是必要的。
最简单的安装方式是使用 'go install' 命令:
go install github.com/wealthy/wealthy-mcp/cmd/wealthy-mcp@latest
这将把 'wealthy-mcp' 可执行文件安装到您的Go bin路径下。请确保您的系统 'PATH' 环境变量包含了Go bin路径。
您也可以访问项目的 GitHub Releases 页面下载预编译好的二进制文件,解压后将其放置到您系统PATH中的任意目录即可运行。在macOS上可能需要额外的权限命令:
chmod +x wealthy-mcp-macos-arm64-<version> xattr -d com.apple.quarantine wealthy-mcp-macos-arm64-<version>
服务器配置 (客户端配置)
MCP服务器不是独立运行的,它需要由MCP客户端(如 Cursor, Claude)来启动和管理。您需要在客户端的配置中指定Wealthy MCP Server的启动方式。
通常,这涉及在客户端的配置目录(如 '~/.cursor/mcp.json')中添加一个服务器配置条目。配置信息是一个 JSON 对象数组,每个对象描述一个MCP服务器。
对于Wealthy MCP Server,您需要添加类似如下的配置(请根据您的客户端和需求调整):
这是一个示例配置,说明了如何定义一个名为 "wealthy-mcp" 的服务器:
- 服务器名称: 'wealthy-mcp' (这是一个在客户端中识别服务器的唯一名称)
- 启动命令: 'command' 字段指定了启动服务器可执行文件的命令,通常是 'wealthy-mcp'。
- 启动参数 (可选): 'args' 字段是一个字符串数组,用于向服务器传递启动参数。例如,'["addr=localhost:8006"]' 可以用来指定服务器监听的地址和端口(默认是Stdio,SSE模式默认监听 'localhost:8004')。
配置示例 (JSON 格式描述,请勿直接复制为代码,仅供理解结构):
{ "mcpServers": { "wealthy-mcp": { "command": "wealthy-mcp", // "args": ["addr=localhost:8006"] // 可选:如需指定地址/端口 } } }
请根据您的MCP客户端文档找到正确的配置文件的位置和格式,并添加Wealthy MCP Server的条目。
基本使用方法
- 安装服务器: 按照上述安装步骤安装 'wealthy-mcp' 可执行文件。
- 配置客户端: 在您的MCP客户端(如 Claude 或 Cursor)的配置文件中添加 Wealthy MCP Server 的配置信息(指定 'wealthy-mcp' 作为命令)。
- 重启客户端: 保存配置文件并重启您的MCP客户端。
- 完成认证: 客户端启动Wealthy MCP Server后,如果需要认证,服务器会自动在浏览器中打开Wealthy登录页面。请完成登录流程。成功登录后,您通常会看到一个提示窗口可以关闭。
- 与LLM交互: 认证成功后,您的LLM客户端现在可以通过Wealthy MCP Server访问Wealthy交易平台的上下文和功能。您可以尝试向LLM发出与交易相关的指令或问题,例如:
- "Show me my current holdings." (显示我的当前持仓)
- "What is the price of [股票代码]?" ( [股票代码] 的价格是多少?)
- "Buy 10 shares of [股票代码] at market price." (以市场价格买入 [股票代码] 10股)
- "Show me my open orders." (显示我的未完成订单)
- "Tell me about [公司名称/股票代码]." (告诉我关于 [公司名称/股票代码] 的信息)
LLM会利用Wealthy MCP Server提供的工具来执行这些任务并获取相关信息。
信息
分类
商业系统