关于 DeXe DAO governance
dexe-mcp 是面向 BNB Chain 上 DeXe Protocol 治理的服务,也提供 OpenZeppelin 和 Compound-Bravo Governor DAO 的读取与治理工具。它适用于需要检查 DAO 活动或构建、管理治理交易的 MCP 客户端,并将签名与交易构建分开控制。
主要功能
- 01DAO 部署与提案工作流
- 02投票、委托与执行
- 03国库和子图数据读取
- 04OTC 代币销售与 IPFS 元数据
- 05支持 Governor DAO
- 06交易模拟与报告
适用场景
- 01创建 DAO 并提交治理提案
- 02检查国库、成员和提案活动
- 03通过报告追踪 DAO 变动
- 04在钱包签名前构建并模拟交易
MCP 相关
向 MCP 客户端提供类型化治理工具,并提供可通过 stdio 或 Streamable HTTP 使用的 54 工具只读版本。写入工具默认返回交易载荷;广播交易须明确启用并经人工批准。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
48收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| chainId | integer | 否 | 读取的链:56 为主网,97 为测试网。需要对应的 RPC。默认值:已配置的链。 |
| deployer | string | 是 | 将发送 deployGovPool tx 的地址(tx.origin) |
| poolName | string | 是 | 唯一的池名称——是 CREATE2 salt 的一部分 |
详细介绍
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 在每个章节开头都注明了对应配置。
| 分组 | 工具 | 概述 |
|---|---|---|
| 开发工具 | 4 | DeXe-Protocol 工作区的 Hardhat 生命周期:dexe_compile、_test、_coverage、_lint。 |
| 合约解析 | 10 | 列出合约、获取 ABI、查找选择器、读取 NatSpec 和源码,以及解码 calldata 和提案载荷。 |
| DAO 读取 | 34 | dexe_dao_report — 一次调用即可获取整个 DAO 的信息(身份、设置、资金库、成员、委托、专家、验证者、提案、投票参与率、活动和截止时间),并可选择使用 since 获取差异 — 以及 DAO 信息、提案状态/列表/投票者、投票权、资金库、设置、验证者、质押、分配、风险评估、协议级统计数据和子图查询(DAO 列表、成员、专家、委托关系图、用户活动、自由格式的 dexe_graph_query,以及通过 dexe_graph_schema 实时检查架构)。 |
| IPFS | 9 | 使用 Pinata 上传文件、头像和 DAO/提案元数据;更新元数据;生成 JPEG 头像;通过网关回退获取内容;在本地计算 CID。 |
| DAO 部署 | 2 | dexe_dao_create(一次调用完成的组合操作,带预检回滚保护)和 dexe_dao_build_deploy(完整的 deployGovPool 结构体编码器)。 |
| 提案目录和基础工具 | 5 | dexe_proposal_catalog,以及通用的 _build_external、_build_internal、_build_custom_abi、_build_offchain。 |
| 外部提案封装工具 | 20 | 命名构建器:代币转账/分配/销售、资金库提现、验证者、专家、质押等级、黑名单、个人资料更改、投票设置等。 |
| 内部验证者封装工具 | 4 | 验证者委员会提案:余额、设置、每月提现、链下内部提案。 |
| 链下封装工具和身份验证 | 9 | DeXe 后端集成:SIWE 登录、创建链下提案和投票。 |
| 投票、质押、委托、执行和领取构建器 | 26 | 直接通过 EOA 在 GovPool 和 Validators 上写入:存款、投票、委托、执行、领取、质押、购买/领取代币销售份额、多调用。 |
| 组合签名流程 | 12 | dexe_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 工具 | 2 | dexe_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 DAO | 18 | dexe_gov_*:感知治理框架类型的提案/投票/排队/执行/委托、试运行、投票收据,以及对 OZ 和 Bravo Governor 的解码。docs/GOVERNOR.md |
| WalletConnect | 3 | dexe_wc_connect(配对二维码)、dexe_wc_status、dexe_wc_disconnect。在手机上签署交易。docs/WALLETCONNECT.md |
| 诊断 | 1 | dexe_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_JWT | IPFS 上传 | 广播 DAO/提案创建操作(固定元数据)时必需。预览和 dryRun 无需密钥——它们会离线计算相同的 CID。 |
DEXE_IPFS_GATEWAY | IPFS 读取 | 专用网关(Pinata、Filebase、可自托管)。若未设置,则使用公共网关(ipfs.io、dweb.link)。 |
DEXE_PINATA_GATEWAY_TOKEN | IPFS 读取 | 用于受限 Pinata 专用网关的网关密钥。 |
DEXE_IPFS_DISABLE_PUBLIC_FALLBACK | 安全强化 | 设置为 1 可禁用公共网关回退。 |
DEXE_WALLETCONNECT_PROJECT_ID | WalletConnect 签名 | 默认提供一个共享 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_STRICT | CI | 设置为 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 无关联。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。