mcpField
D
DeXe DAO governance

DeXe DAO governance

本地服务
github.com/edward-arinin-web-dev金融数据02 周前更新

关于 DeXe DAO governance

de​xe-mcp 是面向 BNB Chain 上 DeXe Protocol 治理的服务,也提供 OpenZeppelin 和 Compound-Bravo Governor DAO 的读取与治理工具。它适用于需要检查 DAO 活动或构建、管理治理交易的 MCP 客户端,并将签名与交易构建分开控制。

主要功能

  1. 01DAO 部署与提案工作流
  2. 02投票、委托与执行
  3. 03国库和子图数据读取
  4. 04OTC 代币销售与 IPFS 元数据
  5. 05支持 Governor DAO
  6. 06交易模拟与报告

适用场景

  1. 01创建 DAO 并提交治理提案
  2. 02检查国库、成员和提案活动
  3. 03通过报告追踪 DAO 变动
  4. 04在钱包签名前构建并模拟交易

MCP 相关

向 MCP 客户端提供类型化治理工具,并提供可通过 stdio 或 Streamable HTTP 使用的 54 工具只读版本。写入工具默认返回交易载荷;广播交易须明确启用并经人工批准。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"edward-arinin-web-dev-dexe": {
"command": "npx",
"args": [
"-y",
"dexe-mcp"
]
}
}
}
启动命令npx -y dexe-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmdexe-mcp0.37.1

工具

48

收录的工具列表 · 更新于 2 周前

参数类型必填说明
chainIdinteger否读取的链:56 为主网,97 为测试网。需要对应的 RPC。默认值:已配置的链。
deployerstring是将发送 deployGovPool tx 的地址(tx.origin)
poolNamestring是唯一的池名称——是 CREATE2 salt 的一部分

详细介绍

dexe-mcp

npm node license MCP-compatible

dexe-mcp

一个用于 BNB Chain 上 DeXe Protocol 治理的 MCP(Model Context Protocol)服务,并为 OpenZeppelin 和 Compound-Bravo Governor DAO(Uniswap、Compound、Optimism)提供额外的通用功能。

它提供 19 组共 170 个类型化工具,涵盖 DAO 部署、DeXe 的全部 33 种提案类型、投票、委托、执行、OTC 代币销售、金库和子图读取、一键式 DAO 报告、IPFS 元数据、交易模拟、多 Agent 编排和诊断。任何能够启动本地命令的 MCP 客户端都可以使用它,包括 Claude Code、Claude Desktop、Cursor、Codex CLI 或自定义 Agent。此软件包还提供只读版 dexe-mcp-read(54 个仅读取数据的工具,支持通过 stdio 或 HTTP 供远程客户端使用)——请参阅只读版。

写入操作优先返回 calldata:工具会返回 { to, data, value, chainId } 负载,供你使用自己的钱包签名。是否由服务广播交易需显式选择,且每笔交易都由人工确认:通过 WalletConnect(在手机上批准,磁盘上不存储密钥——默认方式),或使用加密的本地密钥库(每批交易都需在本地页面输入密码批准)。明文热密钥可用于无人值守签名,仅供机器人和 CI 使用,默认面向测试网。docs/SIGNING.md 介绍了各种模式及其防护范围。

安装 · 快速开始 · 工具目录 · 环境变量 · 文档


在 Claude Code 中安装

在 Claude Code 中输入两条命令:

/plugin marketplace add edward-arinin-web-dev/dexe-mcp
/plugin install dexe@dexe-mcp

然后询问:

“显示 BSC 上 0x… 的金库。”

无需配置即可读取数据:链上数据、子图、DeXe 后端和 IPFS 均有公开的默认设置,并且可立即使用 WalletConnect 签名(dexe_wc_connect)。通过插件会安装 8 个技能——dexe-setup、dexe-create-dao、dexe-create-proposal、dexe-vote-execute、dexe-otc、dexe-staking、dexe-report(无需配置)和 dexe-agent-team(需要设置 DEXE_TOOLSETS=core,agents,并在 DEXE_SIGNER_MODE=unattended 下配置热密钥)。

要创建 DAO 或提案,或广播交易,请运行 /dexe-setup——它会引导你设置解锁这些功能所需的两个密钥(用于上传 IPFS 的 Pinata 令牌和签名者),并将其写入服务实际加载的 .env 文件(插件安装时为 ~/.dexe-mcp/.env)。

使用 Cursor、Claude Desktop、Codex CLI、其他本地 MCP 客户端或终端?请参阅 docs/INSTALL.md。

只读版本(dexe-mcp-read)

同一软件包中的第二个二进制文件仅提供 54 个只读工具:DAO、提案、投票和投票者、金库、成员、委托、验证者和专家、代币销售、质押、协议统计信息以及外部 Governors。它无法签名、发送、上传或构建交易——相关代码甚至不会加载到其进程中——并且不会在调用之间保留任何内容。无需配置即可读取;如果它在共享的 .env 中发现任何签名密钥或上传密钥,会忽略并丢弃这些密钥。

claude mcp add dexe-read -- npx -y -p dexe-mcp dexe-mcp-read      # Claude Code
{ "mcpServers": { "dexe-read": { "command": "npx", "args": ["-y", "-p", "dexe-mcp", "dexe-mcp-read"] } } }

dexe-mcp-read serve-http 通过 MCP Streamable HTTP 为远程客户端提供相同的工具(Claude.ai 自定义连接器、ChatGPT 开发者模式);它附带 Docker 镜像配方,目前为预发布版。运维人员请参阅:docs/REMOTE.md。

快速开始(其他 MCP 客户端)

读取操作无需任何环境配置。以下步骤用于设置上传和签名。

向导方式:

npx -y dexe-mcp@latest --version   # what you are about to run
npx -y dexe-mcp@latest init        # interactive setup: network, Pinata, signer mode
npx -y dexe-mcp@latest doctor      # verifies RPC, Pinata, IPFS gateway, subgraph

--help 和 --version 会直接打印信息并退出,不会加载任何环境。init 会写入 ~/.dexe-mcp/.env(从源码检出目录运行时则写入仓库根目录下的 .env),并打印一段客户端配置片段供你粘贴。doctor 会检查所有已识别的 DEXE_* 变量,并提供通过/警告/失败结果及修复提示;零配置安装出现警告是正常的,且命令会以 0 退出——传入 --strict(或设置 DEXE_DOCTOR_STRICT=1)可使警告在 CI 中以 1 退出;如果实际检查失败,则会以 2 退出。完整运行手册:docs/SETUP.md;检查参考:docs/DOCTOR.md;升级说明:docs/MIGRATION.md。

已经全局安装?请改用 dexe-mcp init——**不要混用这两种方式。**全局安装会遮蔽 npx dexe-mcp@<version>,导致它静默运行旧代码(docs/INSTALL.md)。

手动方式——在 MCP 客户端中注册(.mcp.json、claude_desktop_config.json、Cursor 设置):

{
  "mcpServers": {
    "dexe": {
      "command": "npx",
      "args": ["-y", "dexe-mcp@latest"]
    }
  }
}

全局安装时,相同的配置块为 { "command": "dexe-mcp" }。只有在想覆盖默认值时,才添加 env 配置块:

{
  "mcpServers": {
    "dexe": {
      "command": "dexe-mcp",
      "env": {
        "DEXE_RPC_URL_MAINNET": "https://bsc-dataseed.bnbchain.org"
      }
    }
  }
}

env 配置块是可选的——不设置时,服务会回退到公共 BSC RPC,该节点有速率限制,适用于评估;生产环境请设置自己的端点。

**Windows:**如果 MCP 客户端无法在 PATH 中找到 dexe-mcp 启动脚本,请直接指定脚本路径: { "command": "node", "args": ["<npm root -g>/dexe-mcp/dist/index.js"] }

调用示例(以下四个工具都在默认配置集中——无需设置 DEXE_TOOLSETS,也无需配置环境变量):

// The whole DAO in one call: identity, treasury, members, delegation,
// turnout, and everything with a deadline
dexe_dao_report({ govPool: "0x...", chainId: 56 })

// ...and on the next run, only what moved since the previous one
dexe_dao_report({ govPool: "0x...", chainId: 56, since: "last" })

// Enumerate every proposal type the server can build
dexe_proposal_catalog({ category: "all", implementedOnly: true })

// Create a proposal of ANY catalog type — proposalType + params
dexe_proposal_create({
  govPool:      "0x...",
  title:        "Pay the audit invoice",
  proposalType: "token_transfer",
  params:       { token: "0x...", recipient: "0x...", amount: "1000.0" }
})

dexe_proposal_create 覆盖所有链上目录类型;专用的 dexe_proposal_build_* 构建器(原始 calldata,每种类型一个工具)需要设置 DEXE_TOOLSETS=core,proposals。

每个写入工具都会返回一个 TxPayload,供你传给钱包。若要改由服务广播交易,可以通过 WalletConnect 连接钱包(dexe_wc_connect),或使用 npx dexe-mcp key create 创建加密密钥,并设置 DEXE_SIGNER_MODE=keystore——此后,每个批次(以及每次链下登录或 Safe 签名)都会打开本地审批页面并要求输入密码;也可以在终端中运行 npx dexe-mcp approve 进行审批。这样即可启用组合工作流 dexe_proposal_create、dexe_proposal_vote_and_execute 和 dexe_tx_send。热密钥 DEXE_PRIVATE_KEY 仅在 DEXE_SIGNER_MODE=unattended 时用于签名(适用于机器人、CI);请参阅 docs/SIGNING.md。

要求

  • Node.js ≥ 20.12,且 npm 可正常工作(读取 .env 时会用到的 process.loadEnvFile 需要 20.12+)。使用 node -v 检查。
  • Git——仅可选的开发工具集(dexe_compile / dexe_test / dexe_lint)需要它,该工具集首次使用时会浅克隆 DeXe-Protocol。设置 DEXE_PROTOCOL_PATH 可使用现有检出目录。读取、构建器和部署都不会用到它。

功能特性

  • DeXe 治理覆盖范围:33 种提案类型(24 种外部、4 种内部验证者、5 种链下),验证者委员会、专家委托,以及带有 Merkle 白名单的多层 OTC 销售。
  • 以 calldata 为核心的密钥模型:任何构建工具都不需要私钥。广播是单独的显式选择。
  • 零配置读取:默认提供公共 RPC、子图、后端和 IPFS 网关,让读取工具开箱即用——包括 dexe_dao_report,它可在一次调用中返回完整 DAO 信息(身份、资金库、成员资格、委托、投票率、截止时间),并可与自身上次运行的结果进行比较。docs/REPORTING.md
  • 支持外部 Governor:18 个 dexe_gov_* 工具可针对 OpenZeppelin 和 Bravo Governors 读取、构建、模拟和解码;新增 DAO 只需添加配置项。
  • 多 Agent 编排:以多个钱包作为不同角色,针对同一个 DAO 执行操作。写入组合工具(dexe_dao_create、dexe_proposal_create、dexe_proposal_vote_and_execute、dexe_tx_send、OTC 买家组合工具)中的 signerKey 用于选择由哪个密钥环钱包签名;dexe_agents_fund 会预览资金计划,并且只有在 confirm: true 时才会转移资产,同时强制执行每个 Agent 的上限和滚动 24 小时支出预算;dexe_agents_ledger 会报告哪个角色执行了哪些操作,以及相应费用。把一组热密钥放在 .env 中,就像手里拿着一把上膛的枪——在让这些角色操作持有真实资金的 DAO 之前,请阅读 docs/AGENTS.md,了解安全模型、哪些措施会强制执行、哪些仅提供建议,以及优先使用测试网的工作流。
  • 经链上测试:包含 69 种场景的多 Agent 测试框架,会针对 BSC 测试网模拟 DAO 测试夹具验证构建器——涵盖所有提案类型的仅构建检查,以及广播路径的完整提案 → 投票 → 执行生命周期。
  • MIT 许可、无遥测、无托管依赖——请求仅发送至你配置的端点。

示例应用

经过验证的提示词级场景位于 docs/USE_CASES.md,每个场景都列出了其使用的确切工具和链上证据。主要示例:

  • 基础操作——一次调用即可创建带有自身代币的 DAO;提案 → 投票 → 执行;加入现有 DAO。
  • 基于实时数据的问答——“DAO X 有验证者吗?”、大户图谱、TVL 图表、委托关系图、各提案的投票者名单。(自 v0.31.0 起,报告读取工具已包含在默认配置中且无需密钥:dexe_dao_report、dexe_graph_query、dexe_graph_schema、DAO 列表/成员/统计、代币持有者、委托关系图。dexe_dao_report 的 turnout 部分已包含每项提案的投票者人数。其他较少用到的读取工具——指定投票者名单(dexe_proposal_voters)、验证者名单、用户活动、本地专家、协议统计、NFT、收件箱/预测/风险——仍位于 read 配置中:设置 DEXE_TOOLSETS=core,read(或 full),或询问 dexe_context 哪些工具组已关闭以及如何启用它们。)
  • 自动化——将读取工具与 Agent 的调度器(/loop、/schedule)配合使用:定时运行的 dexe_dao_report 配合 since: "last",只报告自上次运行以来发生变化的内容;还可用于提案监控、每日治理摘要(dexe_user_inbox)、法定人数追踪、资金库监控,以及基于策略的委托 Agent。
  • 分析——解码并评估任何提案的风险(法定人数安全性、面临风险的资金库资产、受益者);购买前对 DAO 进行尽职调查;广播前进行模拟。
  • 高级操作——让 DAO 调用任意外部合约(custom_abi)、进行 OTC 销售、跨 DAO 委托(一个 DAO 在另一个 DAO 中投票——已在主网上运行)、外部 Governor DAO、Safe 多签。

工具目录

19 个组,共 170 个工具。每个工具的完整参考和必需环境变量见:docs/TOOLS.md。 默认会话加载 core 配置——46 个工具,tools/list 约 94 KB。 包括引导工具(dexe_context、dexe_write_context、dexe_guide、dexe_doctor)、单次调用的组合工具(dexe_dao_create、dexe_proposal_create、dexe_proposal_vote_and_execute、四个 dexe_otc_* 组合工具,以及代币销售读取工具 dexe_read_token_sale_position / dexe_read_token_sales)、签名工具(dexe_tx_send、dexe_tx_approval_status、WalletConnect、关键投票构建器)、IPFS 上传三件套及 dexe_ipfs_fetch、dexe_dao_info / dexe_dao_registry_lookup / dexe_dao_predict_addresses、dexe_proposal_state / _list / _catalog、dexe_read_treasury / _settings,以及零配置报告读取工具(dexe_dao_report、dexe_graph_query、dexe_graph_schema、DAO 列表/成员/统计、代币持有者、委托关系图)。关于要启用哪个配置以及各配置的开销,请参阅:docs/PROFILES.md。

v0.31.0 变更:约 30 个单一用途的 dexe_proposal_build_* 构建器不再默认加载——dexe_proposal_create 可通过 proposalType + params 覆盖链上目录中的所有类型,dexe_proposal_catalog 仍会枚举这些类型。设置 DEXE_TOOLSETS=core,proposals 可精确恢复 v0.31 之前的默认配置。添加配置(proposals、read、vote、agents、governor、dev),或设置 DEXE_TOOLSETS=full 以启用全部工具——请参阅 docs/PROFILES.md。使用 full 前请注意:它会注册全部 170 个工具,而某些宿主(VS Code / GitHub Copilot)会将每个请求中启用的工具数限制为 128 个,超出后会拒绝会话;超过限制时,服务会在启动时打印提示。每个会话都应先调用 dexe_context:它会返回当前链、环境就绪情况、未启用的配置及各自提供的功能,以及此前会话中记录的 DAO/提案。自 v0.36.0 起,签名者、Agent 密钥环以及 Pinata / WalletConnect / Safe 的状态由 dexe_write_context 提供。

v0.32.0 新增:agents,用于运行多角色 Agent 集群的第七个配置——dexe_agents_list(查看密钥环中有哪些 Agent 及其余额)、dexe_agents_fund(为其充值,先预览再确认,并受强制上限约束)和 dexe_agents_ledger(查看谁做了什么,以及花费多少)。设置 DEXE_TOOLSETS=core,agents 并重启;如果场景需要原始委托和验证者构建器,则添加 vote(core,agents,vote)。dexe_agents_list / dexe_agents_fund 也仍包含在 vote 中,因此现有的 core,vote 会话所能使用的工具与之前完全相同。详情和安全模型请参阅:docs/AGENTS.md。

Tools 列统计的是整个工具组,而非默认会话加载的数量——大多数组都需通过配置启用。docs/TOOLS.md 在每个章节开头都注明了对应配置。

分组工具概述
开发工具4DeXe-Protocol 工作区的 Hardhat 生命周期:dexe_compile、_test、_coverage、_lint。
合约解析10列出合约、获取 ABI、查找选择器、读取 NatSpec 和源码,以及解码 calldata 和提案载荷。
DAO 读取34dexe_dao_report — 一次调用即可获取整个 DAO 的信息(身份、设置、资金库、成员、委托、专家、验证者、提案、投票参与率、活动和截止时间),并可选择使用 since 获取差异 — 以及 DAO 信息、提案状态/列表/投票者、投票权、资金库、设置、验证者、质押、分配、风险评估、协议级统计数据和子图查询(DAO 列表、成员、专家、委托关系图、用户活动、自由格式的 dexe_graph_query,以及通过 dexe_graph_schema 实时检查架构)。
IPFS9使用 Pinata 上传文件、头像和 DAO/提案元数据;更新元数据;生成 JPEG 头像;通过网关回退获取内容;在本地计算 CID。
DAO 部署2dexe_dao_create(一次调用完成的组合操作,带预检回滚保护)和 dexe_dao_build_deploy(完整的 deployGovPool 结构体编码器)。
提案目录和基础工具5dexe_proposal_catalog,以及通用的 _build_external、_build_internal、_build_custom_abi、_build_offchain。
外部提案封装工具20命名构建器:代币转账/分配/销售、资金库提现、验证者、专家、质押等级、黑名单、个人资料更改、投票设置等。
内部验证者封装工具4验证者委员会提案:余额、设置、每月提现、链下内部提案。
链下封装工具和身份验证9DeXe 后端集成:SIWE 登录、创建链下提案和投票。
投票、质押、委托、执行和领取构建器26直接通过 EOA 在 GovPool 和 Validators 上写入:存款、投票、委托、执行、领取、质押、购买/领取代币销售份额、多调用。
组合签名流程12dexe_guide(任何多步骤请求都应先调用)、dexe_proposal_create、dexe_proposal_vote_and_execute、dexe_tx_send、dexe_tx_status、dexe_tx_approval_status(keystore 审批,只读)、dexe_get_config、dexe_context、dexe_write_context(签名者、密钥环、上传/WalletConnect/Safe 状态),以及 Agent 密钥环 — dexe_agents_list、dexe_agents_fund 和 dexe_agents_ledger(v0.32),这些工具仅在启用 agents 配置时开放。
Merkle 工具2dexe_merkle_build 和 dexe_merkle_proof,兼容 OZ StandardMerkleTree。
OTC 组合工具4开启多级销售、读取买家的持仓(dexe_read_token_sale_position)、购买(原生代币或使用 merkle 证明)、领取已归属的款项。docs/OTC.md
Safe 多签2将交易加入 Safe Transaction Service 队列,而不是广播交易。docs/SAFE.md
模拟器3使用解码后的回滚原因进行 eth_call 预检:_sim_calldata、_sim_proposal、_sim_buy。docs/SIMULATOR.md
多 DAO 收件箱 + 预测2查看 N 个 DAO 中的待处理事项(dexe_user_inbox),并预测基于法定人数的通过率。docs/INBOX.md
外部 Governor DAO18dexe_gov_*:感知治理框架类型的提案/投票/排队/执行/委托、试运行、投票收据,以及对 OZ 和 Bravo Governor 的解码。docs/GOVERNOR.md
WalletConnect3dexe_wc_connect(配对二维码)、dexe_wc_status、dexe_wc_disconnect。在手机上签署交易。docs/WALLETCONNECT.md
诊断1dexe_doctor:检查已配置环境中的可达性,并打印修复建议。

环境变量

启动服务不需要任何变量;缺少变量时,需要该变量的工具会报错并说明需要设置什么。完整列表请参阅:docs/ENVIRONMENT.md。

变量用途备注
DEXE_RPC_URL_MAINNET / DEXE_RPC_URL_TESTNET / DEXE_RPC_URL_<chainId>所有链上工具每条链的 JSON-RPC 端点。若未设置任何端点,则使用公共 BSC RPC(有速率限制)。DEXE_RPC_URL 仍可用作旧版单链别名。
DEXE_DEFAULT_CHAIN_ID链选择默认值为 56(BSC 主网);测试网使用 97。
DEXE_DISABLE_PUBLIC_RPC安全强化设置为 1 可关闭公共 RPC 回退,包括 BSC,以及 dexe_gov_* 工具使用的支持归档的 Ethereum/Optimism 回退。
DEXE_PINATA_JWTIPFS 上传广播 DAO/提案创建操作(固定元数据)时必需。预览和 dryRun 无需密钥——它们会离线计算相同的 CID。
DEXE_IPFS_GATEWAYIPFS 读取专用网关(Pinata、Filebase、可自托管)。若未设置,则使用公共网关(ipfs.io、dweb.link)。
DEXE_PINATA_GATEWAY_TOKENIPFS 读取用于受限 Pinata 专用网关的网关密钥。
DEXE_IPFS_DISABLE_PUBLIC_FALLBACK安全强化设置为 1 可禁用公共网关回退。
DEXE_WALLETCONNECT_PROJECT_IDWalletConnect 签名默认提供一个共享 ID;生产环境请设置自己的项目 ID。
DEXE_SIGNER_MODE签名walletconnect(默认) · keystore(加密密钥,每批次在本地页面输入密码 — npx dexe-mcp key create) · readonly · unattended(热密钥,无需确认,仅限 DEXE_UNATTENDED_CHAINS,默认值为 97)。请参阅 docs/SIGNING.md。
DEXE_PRIVATE_KEY无人值守模式热密钥签名,仅在 DEXE_SIGNER_MODE=unattended 时读取。若未设置该模式,则忽略热密钥(自 1.0.0 起)。请使用 npx dexe-mcp key import --from-env 将其导入密钥库。
DEXE_TOOLSETS工具集控制以逗号分隔的配置列表;默认值为 core(v0.31.0;此前为 core,proposals)。有效值:core、proposals、read、vote、agents、governor、dev、full。agents(v0.32.0)会添加密钥环集群工具 — DEXE_TOOLSETS=core,agents。
DEXE_SUBGRAPH_POOLS_URL / _VALIDATORS_URL / _INTERACTIONS_URL子图读取The Graph 端点;默认指向去中心化网络。
DEXE_GRAPH_API_KEY子图读取仅当 URL 未包含密钥时需要设置。
DEXE_BACKEND_API_URL链下提案DeXe 后端,例如 https://api.dexe.io。
DEXE_STATE_PATH持久化覆盖会话状态文件(~/.dexe-mcp/state.json)。
DEXE_PROTOCOL_PATH开发工具集已有的 DeXe-Protocol 检出目录;设置后禁用自动克隆。
DEXE_SAFE_DELEGATECALL安全强化设置为 block 可直接拒绝 Safe 的 operation: 1。默认情况下,DELEGATECALL 需要在调用中明确设置 allowDelegateCall: true。
DEXE_DOCTOR_STRICTCI设置为 1 可使 dexe-mcp doctor 在出现警告时以 1 退出(与 --strict 相同)。

文档

  • docs/USE_CASES.md — 已验证的用例目录:可以对 Agent 说什么、会发生什么、链上证据。
  • docs/PLAYBOOK.md — AI 操作手册:意图 → 精确调用、各类型参数、错误 → 补救措施。也作为 MCP 资源 dexe://playbook 提供。
  • docs/TOOLS.md — 全部 170 个工具,按组列出,并附有单行说明、每个部分所需的工具集配置文件,以及必需的环境变量。也作为 MCP 资源 dexe://tools 提供。
  • docs/REPORTING.md — dexe_dao_report:一次调用即可生成的 DAO 报告、报告章节、since 差异,以及按计划运行的方法。
  • docs/USAGE.md — 可直接复制粘贴的 JSON 示例。
  • docs/ENVIRONMENT.md — 完整的环境变量参考和常见问题。
  • docs/INSTALL.md — 各 MCP 客户端的安装说明。
  • docs/PROFILES.md — 应运行哪个 DEXE_TOOLSETS 配置文件、各配置文件在 tools/list 中的开销,以及主机工具数量上限。
  • docs/SETUP.md / docs/DOCTOR.md — 设置向导和诊断参考。
  • docs/AGENTS.md — 多角色 Agent 团队:热密钥集群的安全模型、agents 工具集、资金限制、可在链上运行的执行顺序,以及归因账本。
  • docs/SKILLS.md — 随软件包提供的 Claude Code 技能。
  • docs/GRAPH.md — dexe_graph_query 的子图实体参考(池 / 交互 / 验证者)。也作为 MCP 资源 dexe://graph-schema 提供。
  • docs/GOVERNOR.md — 外部 OZ/Bravo Governor 功能。
  • docs/SIGNING.md — 签名者模式(WalletConnect、加密密钥库、只读、无人值守)、审批页面和威胁模型。
  • docs/WALLETCONNECT.md — 无需热密钥,通过手机批准签名。
  • docs/OTC.md — 面向所有者和买家的多层级 OTC 销售流程。
  • docs/PROFILE.md — DAO 资料和头像流程。
  • docs/SIMULATOR.md — 带有回滚解码的预检模拟。
  • docs/INBOX.md — 跨 DAO 收件箱和提案预测。
  • docs/MIGRATION.md — 各版本升级说明。
  • docs/REMOTE.md — 只读版本 dexe-mcp-read:stdio 设置,以及通过 HTTP(serve-http、Docker)托管,供远程客户端使用。

Swarm 测试工具集

tests/swarm/ 是一个多 Agent 测试工具集,用于针对真实的 BSC-testnet DAO 测试工具功能:包含 69 个 JSON 场景,涵盖委托链、验证者议会、每种提案类型的仅构建检查、OTC 流程和完整的广播生命周期。编排器会解析 Agent 钱包,并通过内联 ethers 分发器或 dexe-mcp stdio 桥接来执行每个步骤。

npm run swarm:preflight                # per-wallet readiness table
npm run swarm:fund -- --confirm        # top up agent wallets from the funder
npm run swarm:run                      # full sweep
npm run swarm:run -- --scenarios=S00-reset --dry-run

设置操作手册:tests/swarm/README.md · 场景架构:tests/swarm/scenarios/_schema.md · Agent 提示词:tests/swarm/prompts/。

贡献

git clone https://github.com/edward-arinin-web-dev/dexe-mcp.git
cd dexe-mcp
npm install
npm run build
npm test
npm run dev          # watch mode

问题、PR 和提案类型请求:GitHub issues。

安全

请参阅 SECURITY.md,了解威胁模型、政策以及如何报告漏洞。简而言之:

  • 发布标签均使用 GPG 签名;发布前,release.yml 会运行 git verify-tag。导入维护者密钥后,可在本地使用 git verify-tag <tag>(例如 v0.19.0)进行验证。
  • npm 发布使用 --provenance;可通过 npm audit signatures 验证。
  • CI 严格依据已提交的锁文件进行安装,发现偏差时会失败。
  • CodeQL、OSSF Scorecard 和 Dependency Review 会在 PR 上及按计划运行。

许可证

MIT。请参阅 LICENSE。


面向 DeXe Protocol 治理技术栈的独立开源集成项目。与 DeXe Network 无关联。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。