Beneat MCP

@beneat/risk mcp服务器

为人工智能交易代理提供风险执行和行为指导。19个工具（18个核心+1个语义路由器）通过MCP（stdio+HTTP）和一个简单的REST API-交易前验证、损益跟踪、会话校准、行为分析和通过Cohere Rebank的自然语言意图路由。

参考实现连接到 Solana+漂移协议。链适配器位于 src/lib/ --将它们交换出去以使用任何交换或链。看 适应其他链条.

你的代理人交易。Beneat确保它不会爆炸。

托管实例

Beneat MCP在线 https://beneat-mcp.onrender.com。无需安装。

添加到任何MCP客户端配置：

{
  "mcpServers": {
    "beneat": {
      "type": "streamable-http",
      "url": "https://beneat-mcp.onrender.com/mcp"
    }
  }
}

REST API

curl https://beneat-mcp.onrender.com/health                                         # Health check
curl https://beneat-mcp.onrender.com/api/tools                                      # Tool manifest
curl -X POST https://beneat-mcp.onrender.com/api/tools/beneat_get_status \
  -H "Content-Type: application/json" -d '{"wallet_address":"YOUR_WALLET"}'          # Call any tool
curl -X POST https://beneat-mcp.onrender.com/api/route \
  -H "Content-Type: application/json" -d '{"intent":"am I safe to trade?"}'          # Semantic routing

服务托管

cd mcp-server
npm install && npm run build
npm run start:http    # HTTP on localhost:3001
npm run start         # stdio transport

自定义REST API使用 http://localhost:3001 而不是托管URL。

然后在代理的系统提示中添加一行：

在执行任何交易之前，请致电 beneat_check_trade 带上你的钱包地址。每次交易后，请致电 beneat_record_trade 与P&L。

交易逻辑无代码更改。MCP服务器负责执行。

运作原理

Agent wants to trade
  │
  ├─ beneat_calibrate ──→ Sets risk rules (daily loss limit, max trades, cooldown)
  │                        Returns unsigned TXs to deploy on-chain
  │
  ├─ beneat_check_trade ──→ Pre-flight: lockout? cooldown? budget left?
  │                          Returns approved/denied + coaching context
  │
  ├─ [Agent executes trade]
  │
  ├─ beneat_record_trade ──→ Logs P&L in session tracker
  │                           Daily loss limit breached?
  │                             ├─ YES → Lockout triggered → AgentWallet FROZEN
  │                             └─ NO  → Continue trading
  │
  └─ beneat_check_trade ──→ DENIED (vault locked, wallet frozen)
                             Agent blocked until lockout expires

Vault可选模式

7个工具在没有Beneat vault帐户的情况下工作，回到Helius交易历史分析：

任何Solana交易代理都可以在咨询模式下立即开始使用Beneat。创建保险库以解锁完全强制执行。

工具（19）

核心执法

代理教练

发现与监控

管理和注册

语义路由

也可用作 POST /api/route 对于MCP之外的REST客户端。

校准层

校准引擎会根据代理商的交易历史进行调整：

策略预设：

风险承受水平：

快速开始

# Build
cd mcp-server
npm install
npm run build

# Run the demo (full enforcement lifecycle)
npm run demo

# Run E2E tests (all 19 tools)
npm run test:e2e

# Start the server (stdio transport)
npm run start

# Start HTTP server (REST + MCP-over-HTTP)
npm run start:http

# Open MCP Inspector UI
npm run inspect

环境变量

建筑

src/
├── index.ts                    # Server setup, 19 tool registrations, --http flag
├── http-server.ts              # HTTP server: REST endpoints + /api/route semantic routing
├── tool-registry.ts            # ToolDefinition interface, TOOL_REGISTRY, tool document builder
├── tools/                      # One file per tool
│   ├── check-trade.ts          # Core: pre-flight authorization
│   ├── record-trade.ts         # Core: P&L logging + lockout trigger
│   ├── calibrate.ts            # Core: 3-tier auto-calibration
│   ├── analytics.ts            # Behavioral analysis + directives
│   ├── playbook.ts             # Personalized trading playbook
│   ├── session-strategy.ts     # Dynamic session limits
│   ├── smart-route.ts          # Semantic tool routing via Cohere Rerank
│   └── ...                     # 12 more tools
├── lib/
│   ├── quant-engine.ts         # Calibration + analytics engine (~1250 lines)
│   ├── vault-reader.ts         # On-chain vault/profile/Drift deserialization
│   ├── transaction-builder.ts  # Unsigned VersionedTransaction construction
│   ├── session-store.ts        # In-memory session tracking + inferSessionState()
│   ├── reranker.ts             # Cohere Rerank client with graceful fallback
│   ├── helius-client.ts        # Helius API with circuit breaker
│   ├── agentwallet-client.ts   # AgentWallet policy enforcement
│   ├── scoring.ts              # Trust score (0-100) computation
│   ├── types.ts                # All TypeScript interfaces
│   ├── constants.ts            # Program IDs, seeds, strategy defaults
│   ├── utils.ts                # safeCall, bigintReplacer, jsonContent helpers
│   └── pda.ts                  # Vault & profile PDA derivation
└── generated/vault/            # Codama-generated IDL types (do not edit)

关键设计决策

从不签署交易。 服务器构建未签名的 VersionedTransaction 对象（base64编码）供调用者签名。私钥永远不会接触MCP服务器。

保险库可选回退。 当不存在保险库时，工具会回退到Helius交易历史中进行分析和咨询模式执行。代理可以在没有任何链上设置的情况下启动。

机器可读输出。 结构化分析回报 directives[] （例如。， { type: "avoid_market", severity: "warning", params: { market: "PUMP_FUN" } })代理可以通过编程方式进行消费。

会话状态分类。 教练引擎将代理分为5种状态（正常、无后入、倾斜、热破、后入回），并相应地调整头寸规模、交易限额和市场建议。

链上项目

PDA种子： ["vault", owner] 和 ["trader_profile", authority]

适应其他链条

业务逻辑——校准、会话状态、行为分析、辅导、评分、语义路由——与链无关。中只有四个文件 src/lib/ 是索拉纳特有的。分叉并替换它们以针对任何交易所或链：

一切都在 quant-engine.ts, session-store.ts, scoring.ts, reranker.ts，以及所有 src/tools/ 保持不变。

咨询模式（无需连锁）

19个工具中有14个完全在内存会话状态下运行-无需钱包，无需RPC，无需API密钥。适用于测试、CEX代理或链上状态不可用的任何环境。

依赖项

许可证

麻省理工学院