AI交易客户端

OpenOrderbook MCP——通过人工智能进行固定回报期权和1X2交易

使用人工智能交易固定回报期权（FRO）和三个结果事件（1X2）。该存储库提供了两种与OpenOrderbook平台交互的方式：

这两种方法都使用相同的双服务器签名架构——你的密钥永远不会离开你的机器。

运作原理

graph LR
    A["AI Client or VS Code + Copilot<br/>(your machine)"] -- stdio --> B["Local Signer MCP<br/>(signs transactions<br/>with your key)"]
    A -- HTTPS --> C["Remote MCP<br/>(Azure Functions —<br/>validates & relays)"]
    C -- HTTPS --> D["OpenOrderbook<br/>(blockchain relay)"]

• 本地签名者MCP --在您的计算机上运行，持有您的私钥，在本地签署交易。您的密钥永远不会离开您的设备。
• 远程MCP --托管在Azure上，在服务器端验证签名，将签名的交易中继到OpenOrderbook区块链中继。
• AI客户端/副驾驶 --编排工作流：在本地签名→ 远程提交→ 投票确认。

选项A——独立AI客户端（推荐给交易者）

一个独立的终端应用程序。无需VS Code或Copilot订阅-带上您自己的Anthropic API密钥或运行本地Ollama模型。

快速开始

1. 克隆此存储库 （您需要一个GHE帐户——请参阅 设置-MAC-AI-CLIENT.md PAT指令）：

   复制

   git clone https://horizonfintex.ghe.com/horizon/openorderbook-mcp.git
   cd openorderbook-mcp
   

2. 仅限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
   

3. 运行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
   

4. 回答巫师 --提供您的AI提供者、密钥库路径、密码和Azure AD凭据。配置已保存到 ~/.openorderbook-ai/config.json.

5. 验证 --键入REPL：

   复制

   > check signer status
   > what's my balance?
   

完整设置指南： 设置-MAC-AI-CLIENT.md

选项B——VS代码+GitHub副本

对于已经使用VS Code的开发人员。需要a GitHub Copilot 订阅。

快速开始

1. 克隆此存储库：

   复制

   git clone https://horizonfintex.ghe.com/horizon/openorderbook-mcp.git
   

2. 在VS Code中打开文件夹 --副驾驶拿起 交易技能档案 自动：

   • File → 打开文件夹… → 选择 openorderbook-mcp

3. 仅限macOS --使签名者二进制文件可执行：

   复制

   chmod +x releases/osx-arm64/OpenOrderbookSignerMcp
   xattr -d com.apple.quarantine releases/osx-arm64/OpenOrderbookSignerMcp
   

4. 配置MCP --复制模板并填写您的凭据：

   macOS/Linux：

   复制

   mkdir -p .vscode
   cp config/mcp.json.template .vscode/mcp.json
   

   Windows（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.

5. 启动MCP服务器 --重新加载VS代码(Ctrl+Shift+P → “开发人员：重新加载窗口”），打开MCP面板，启动 本地签名者 和 fro-uat.

6. 验证 --问副驾驶： “检查签名者状态”

完整的设置指南： 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工具更简单——不需要客户端签名，只需要承载令牌认证。

文档

存储库结构

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 带着一个 GitHub Copilot 订阅
• 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。保留所有权利。