Moomoo MCP服务器
连接的MCP服务器 Moomoo已打开 AI代理（Claude、Cursor等）进行自主交易和市场分析。
特性
市场数据
- 实时报价：获取股票的实时快照（价格、交易量、成交额）。
- 历史K线：检索烛台数据（每日、1m、5m等）以进行技术分析。
- 自动订阅：自动处理Moomoo的订阅限制，因此您不必手动管理它们。
- 符号规范化：巧妙地处理以下符号
00700（自动转换为HK.00700基于违约市场）。
账户和资产
- 职位：查看您当前的股票持有量、数量和损益。
- 平衡：检查账户现金、市场价值和购买力。
- 纸张交易准备就绪：自动检测您的环境配置并切换到
Simulate安全模式。
交易与风险
- 交易：地点 市场 和 限制 股票订单。
- 期权链：检查任何股票的可用期权合约。
- 订单管理：修改或取消未结订单。
- 交易执行：查看实际填充价格/费用
get_deals. - 专业工具：查看 二级订单簿 （深度）和检查 基础 （PE、PB）。
- 技术分析：计算 RSI、MACD、布林带、MA 立即与
get_technical_indicators. - 风险管理：检查
margin_ratio防止清算和max_order_value为了安全。 - 高速数据：使用
get_market_snapshot用于低延迟批量报价（1ms效率）。
先决条件
- Moomoo帐户：您需要一个真实或纸质交易账户。
- Moomoo已打开：您的计算机上必须运行官方网关软件。 点击此处下载.
- 数据订阅:
- 交易/查看 美国股票，您的Moomoo帐户必须具有 美国市场数据 订阅。 - 交易/查看 香港股票，你需要 香港市场数据. - *注意：如果您缺乏权限，可以使用以下工具 get_quote("US.AAPL") 将返回权限错误。*
安装
- 先决条件
- 安装 Moomoo已打开 并让它运行。 - Python 3.10+
- 克隆和安装
git clone
cd moomoo-mcp-server
pip install -e .- 配置
创建 .env 根目录中的文件（请参见 .env.example):
# Moomoo OpenD Connection
OPEND_HOST=127.0.0.1
OPEND_PORT=11111
OPEND_PWD= # Leave empty if no unlock password set in OpenD
# Trading Environment
MOOMOO_ENV=paper # 'paper' or 'live'
MOOMOO_DEFAULT_MARKET=HK # Default market prefix (HK, US, CN)快速入门：克劳德桌面
要与连接 Claude桌面应用程序:
- 打开配置：
- 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json
- 添加到
mcpServers:
"moomoo": {
"command": "python",
"args": ["C:/absolute/path/to/moomoo-mcp-server/src/moomoo_mcp/server.py"],
"env": { "MOOMOO_PWD": "your_opend_password" }
}可用工具
| 工具 | 描述 | 参数 |
|---|---|---|
get_quote | 实时价格快照 | symbol （例如，“HK.00700”） |
get_kline | 历史烛台 | symbol, period （默认为“1d”）， limit |
get_option_chain | 列出期权合约 | symbol, start, end |
get_positions | 当前股票持有量 | *无* |
get_balance | 账户资金明细 | *无* |
get_orders | 列出活动/已完成的订单 | symbol （可选） |
cancel_order | 取消未结订单 | order_id |
modify_order | 更改订单价格/数量 | order_id, price, quantity |
buy_stock | 下单（限价/市价） | symbol, quantity, price, order_type |
sell_stock | 下达卖出订单（限价/市价） | symbol, quantity, price, order_type |
get_order_book | 二级市场深度（阶梯） | symbol |
get_financials | 关键比率（市盈率、市盈率、市值） | symbol |
get_max_buyable | 计算最大份额（含原因分析） | symbol, price |
get_deals | 查看已执行的交易填充（仅限Real env） | symbol （可选） |
get_margin_ratio | 检查账户风险/保证金状态 | *无* |
get_market_snapshot | 批量获取报价（快速） | symbols （列表） |
get_technical_indicators | 计算RSI、MACD、MA等。 | symbol, indicators （列表） |
run_diagnostics | 执行自检健康检查 | symbol （可选） |
健康检查和诊断
您可以使用执行完整的系统自检 run_diagnostics 工具。这将检查：
- 打开的连接
- 市场数据延迟
- L2数据访问权限
- 帐户检索
也可以通过脚本运行：
python examples/scripts/test_diagnostics.py验证
您可以使用提供的脚本测试连接和工具：
# Test Market Data
python examples/scripts/quick_quote.py
python examples/scripts/quick_kline.py
# Test Account Data
python examples/scripts/account_snapshot.py
# Test Trading & Options
python examples/scripts/test_advanced.py
# Test Pro Tools
python examples/scripts/test_pro_tools.py
# Test Execution & Safety (Deals, Margin, Snapshot)
python examples/scripts/test_execution_safety.py
# Test Technical Analysis (RSI, MACD, etc.)
python examples/scripts/test_technical_analysis.py贡献
欢迎投稿！请按照以下步骤操作：
- 分叉存储库。
- 创建新分支(
git checkout -b feature/amazing-feature). - 提交您的更改(
git commit -m 'Add some amazing feature'). - 推到分支(
git push origin feature/amazing-feature). - 打开拉取请求。
请确保您遵循现有的代码样式，并为任何新功能添加测试。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
风险与免责声明
该软件用于教育和研究目的。正在验证 paper 强烈建议在任何实时使用之前使用该模式。