OpenOrderbook MCP——通过人工智能进行固定回报期权和1X2交易
使用人工智能交易固定回报期权（FRO）和三个结果事件（1X2）。该存储库提供了两种与OpenOrderbook平台交互的方式：
| 独立AI客户端 | VS代码+副本 | |
|---|---|---|
| 这是什么 | 基于终端的对话式交易REPL | 代码编辑器中嵌入的AI助手 |
| 最佳 | 想要简单聊天界面的交易者 | 想要在IDE中使用AI的开发人员 |
| 设置 | 运行二进制文件，回答向导 | 配置MCP服务器，在VS Code中打开文件夹 |
| 二进制文件 | openorderbook-ai + OpenOrderbookSignerMcp | OpenOrderbookSignerMcp 只有 |
这两种方法都使用相同的双服务器签名架构——你的密钥永远不会离开你的机器。
运作原理
graph LR
A["AI Client or VS Code + Copilot
(your machine)"] -- stdio --> B["Local Signer MCP
(signs transactions
with your key)"]
A -- HTTPS --> C["Remote MCP
(Azure Functions —
validates & relays)"]
C -- HTTPS --> D["OpenOrderbook
(blockchain relay)"]- 本地签名者MCP --在您的计算机上运行，持有您的私钥，在本地签署交易。您的密钥永远不会离开您的设备。
- 远程MCP --托管在Azure上，在服务器端验证签名，将签名的交易中继到OpenOrderbook区块链中继。
- AI客户端/副驾驶 --编排工作流：在本地签名→ 远程提交→ 投票确认。
选项A——独立AI客户端（推荐给交易者）
一个独立的终端应用程序。无需VS Code或Copilot订阅-带上您自己的Anthropic API密钥或运行本地Ollama模型。
快速开始
- 克隆此存储库 （您需要一个GHE帐户——请参阅 设置-MAC-AI-CLIENT.md PAT指令）：
git clone https://horizonfintex.ghe.com/horizon/openorderbook-mcp.git
cd openorderbook-mcp- 仅限macOS --使二进制文件可执行：
# Apple Silicon:
chmod +x releases/osx-arm64/openorderbook-ai releases/osx-arm64/OpenOrderbookSignerMcp
xattr -d com.apple.quarantine releases/osx-arm64/openorderbook-ai releases/osx-arm64/OpenOrderbookSignerMcp- 运行AI客户端 --安装向导在首次运行时启动：
# Apple Silicon:
./releases/osx-arm64/openorderbook-ai
# Intel Mac:
./releases/osx-x64/openorderbook-ai
# Windows:
.\releases\win-x64\openorderbook-ai.exe
# Linux:
./releases/linux-x64/openorderbook-ai- 回答巫师 --提供您的AI提供者、密钥库路径、密码和Azure AD凭据。配置已保存到
~/.openorderbook-ai/config.json.
- 验证 --键入REPL：
> check signer status
> what's my balance?完整设置指南： 设置-MAC-AI-CLIENT.md
______________________________________________________________________
选项B——VS代码+GitHub副本
对于已经使用VS Code的开发人员。需要a 订阅。
快速开始
- 克隆此存储库：
git clone https://horizonfintex.ghe.com/horizon/openorderbook-mcp.git- 在VS Code中打开文件夹 --副驾驶拿起 交易技能档案 自动：
- File → 打开文件夹… → 选择 openorderbook-mcp
- 仅限macOS --使签名者二进制文件可执行：
chmod +x releases/osx-arm64/OpenOrderbookSignerMcp
xattr -d com.apple.quarantine releases/osx-arm64/OpenOrderbookSignerMcp- 配置MCP --复制模板并填写您的凭据：
macOS/Linux：
mkdir -p .vscode
cp config/mcp.json.template .vscode/mcp.jsonWindows（PowerShell）：
New-Item -ItemType Directory -Path .vscode -Force
Copy-Item config\mcp.json.template .vscode\mcp.json编辑 .vscode/mcp.json：set command 通往您平台的完整路径 OpenOrderbookSignerMcp 二进制，并填写密钥库路径、密码和客户端密钥。
> 窗户： 在JSON路径中使用双反斜杠（例如。 C:\\dev\\...).看 SETUP-WINDOWS.md.
- 启动MCP服务器 --重新加载VS代码(
Ctrl+Shift+P→ “开发人员：重新加载窗口”），打开MCP面板，启动 本地签名者 和 fro-uat.
- 验证 --问副驾驶： *“检查签名者状态”*
完整的设置指南： SETUP-MACOS.md · SETUP-WINDOWS.md
______________________________________________________________________
你能做什么
设置后（任一选项），要求AI：
- 浏览市场：“显示所有开放的FRO报价”或“获取AAPL报价”
- 撰写报价：“以200美元的罢工价、5美元的溢价、10份合约的价格对AAPL提出是的报价”
- 购买：“从报价#42购买5份合约”
- 检查您的投资组合：“显示我的作品集”
- 锻炼姿势：“练习姿势#7”
- 二级市场：“以50美元的价格列出第3个待售头寸”或“从第二方购买第3个头寸”
- 跟踪交易：“检查跟踪ID abc-123的状态”
AI处理完整标志→ 提交→ 自动确认工作流。
1X2（三个结果事件）
- 列出事件：“列出4月15日塞尔塔维戈对阵弗莱堡的1X2赛事”
- 出价：“在第5场比赛中提出1X2报价，结果主场获胜，概率0.45，200个数量”
- 接受报价：“订购42件100件”
- 解决：“以主场胜利的结果解决事件5”
- 查询：“显示我的未结1X2头寸”或“我的1X2现金余额是多少？”
1X2工具更简单——不需要客户端签名，只需要承载令牌认证。
文档
| 文档 | 描述 |
|---|---|
| 设置-MAC-AI-CLIENT.md | 独立AI客户端的macOS设置（PAT、向导、配置文件） |
| SETUP-MACOS.md | VS Code+Copilot的macOS设置 |
| SETUP-WINDOWS.md | VS Code+Copilot的Windows设置 |
| 建筑.md | 双服务器模型、签名流程、安全设计 |
| 工具参考.md | 所有80个MCP工具的完整参考（本地+远程EC+远程1X2+本地） |
| 技能.md | 人工智能技能文件——交易流程、参数格式、错误处理 |
存储库结构
releases/
osx-arm64/ openorderbook-ai OpenOrderbookSignerMcp (Apple Silicon)
osx-x64/ openorderbook-ai OpenOrderbookSignerMcp (Intel Mac)
win-x64/ openorderbook-ai.exe OpenOrderbookSignerMcp.exe
linux-x64/ openorderbook-ai OpenOrderbookSignerMcp
config/
mcp.json.template MCP server config template for VS Code
docs/ Setup guides and reference documentation
src/
Abbey.Ethereum/ Ethereum signing library (source)先决条件
- 以太坊密钥库文件（V3 JSON格式）——您的团队负责人将提供一个
- Azure AD客户端凭据——由管理员提供
- AI客户端： 无烟煤API键(
sk-ant-...)从 console.anthropic.com，或本地Ollama实例 - VS代码+副本： VS Code 带着一个 订阅
- Azure AD B2C客户端凭据——您的团队负责人将提供这些凭据
项目结构
openorderbook-mcp/
├── .github/
│ └── copilot-instructions.md # Auto-loaded rules for Copilot
├── config/
│ └── mcp.json.template # MCP config template (copy to .vscode/mcp.json)
├── docs/
│ ├── ARCHITECTURE.md # Architecture & security design
│ ├── SETUP-MACOS.md # macOS setup guide
│ ├── SETUP-WINDOWS.md # Windows setup guide
│ ├── SKILL.md # AI skill file for Copilot
│ └── TOOLS-REFERENCE.md # All MCP tools reference
└── releases/ # Pre-built self-contained binaries
├── osx-arm64/ # Apple Silicon (M1/M2/M3/M4)
├── osx-x64/ # Intel Mac
├── win-x64/ # Windows
└── linux-x64/ # Linux安全模型
- 私钥永远不会离开你的机器 --所有签名都发生在本地签名者MCP进程中
- 服务器端签名验证 --远程MCP在转发到区块链之前验证每个签名
- 承载令牌身份验证 --所有远程MCP调用都需要有效的Azure AD B2C令牌
- 回购中没有秘密 --凭据仅通过环境变量配置
许可证
专有——Horizon Fintex。保留所有权利。