内容
center">
="https://www/package/dexe-mcp">
<imgassets/hero.svg" alt="dexe-mcp" width="100%"/>
</a>
</p>
<p align="center">
<a href="https://www.npmjs/dexe-mcp"><img alt="npm" src="https://img.shields.io/npm/v/dexe-mcp.svg?style=flat-square&labelColor=0b0f1e&color=9BB4FF"></a>
<a href="https://nodejsimg alt="node"https://img.shields.io/node/v/dexe-m?style=flat-square&labelColor=0b0f1e&color=E07AFF"></a>
<a href="https://github.com/edward-arinin-web-dev/dexe-mcp/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/npm/l/dexe-mcp.svg?style=flat-square&labelColor=0b0f1e&color=FFC878"></a>
<a href="https://modelcontextprotocol.io"><img alt="MCP-compatible" src="https://img.shields.io/badge/MCP-compatible-9BB4FF?style=flat-square&labelColor=0b0f1e"></a>
</p>
# dexe-mcp
DeXe 协议治理的MCP（模型上下文协议）服务器，适用于BNB链，并为OpenZeppelin和Compound-Bravo Governor DAOs（Uniswap、Compound、Optimism）提供额外的通用接口。
它提供了19组165种工具：DAO部署、33种DeXe提案类型、投票、委托、执行、场外交易代币销售、 treasury 和 subgraph 读取、IPFS元数据、交易模拟和诊断。任何MCP客户端都可以使用它 — Claude Code、Claude Desktop、Cursor 或自定义代理。
写入操作优先考虑 calldata：工具返回一个 `{ to, data, value, chainId }` 有效载荷，供您的钱包签名。广播来自服务器是可选的，通过WalletConnect（在您的手机上批准交易；磁盘上没有密钥）或您显式配置的私钥。
<p align="center">
<ainstall-in-claude安装</a> ·
a href="#quick-mcp-clients">快速入门</a> ·
<a href="#tool">工具目录</ ·
<a href="#environment-variables">环境变量</a> ·
<="https://github.com/edward-arinin-webdexe-mcp/tree">文档</ap>
---
## 在 中安装
在 中输入两个命令```
/plugin marketplace add edinin-web-dev/-mcp
/pluginxe@dexe-mcp
```
然后询问： "在BSC上显示`0x…`."
读取操作无需配置即可工作：链上数据、subgraphs、DeXe后端和IPFS都有公共WalletConnect签名立即可用（`dexe_connect`）。治理技能、创建提案和执行、场外交易、质押）与安装。
要创建DAO或提案，或广播交易 `/dexe-setup 它将引导您完成的两个密钥IPFS上传的令牌和签名并将它们写入`.。
使用Cursor、ChatGPT、另一个MCP终端？请参阅 [docs/INSTALL.md](./docs/INSTALL.md)。
##入门（其他M）
读取操作无需任何环境。以下步骤设置上传**向导路径：**
```bash
npm install -g dexe-mcp
dexe-mcp init # 交互式设置：网络、Pinata、签名模式
dexe-mcp doctor # 验证RPC、Pinata、IPFS网关、subgraph
```
`init`写入`.env`并打印一个客户端配置代码片段供您粘贴。`doctor`检查每个已识别的`DEXE_*`变量并报告通过/警告/失败，并提供补救提示。完整的操作手册：[docs/SETUP.md](./docs/SETUP.md)；查看参考：[docs/DOCTOR.md](./docs/DOCTOR.md)；升级说明：[docs/MIGRATION.md](./docs/MIGRATION.md)。
**手动路径** — 在您的MCP客户端（`.mcp.json`、`claude_desktop_config.json`、Cursor设置）中注册：
```json
{
"mcpServers": {
"dexe": {
"command": "dexe-mcp",
"env": {
"DEXE_RPC_URL_MAINNET": "https://bsc-dataseed.binance.org"
}
}
}
}
```
`env`块是可选的 — 如果没有它，服务器将回退到公共BSC RPC，该RPC有速率限制，适合评估；为生产使用设置您自己的端点。
> **Windows：** 如果您的MCP客户端无法解析`dexe-mcp` shim在PATH上的位置，请直接指向脚本：
> `{ "command": "node", "args": ["<npm root -g>/dexe-mcp/dist/index.js"] }`
**示例调用：**
```jsonc
// 枚举服务器可以构建的每种提案类型
dexe_proposal_catalog({ category: "all", implementedOnly: true })
// 解析DAO的合约布局：设置/userKeeper/validators地址，
// NFT合约，元数据CID，验证者数量
dexe_dao_info({ govPool: "0x..." })
// 构建代币转移提案；返回已准备好签名的calldata
dexe_proposal_build_token_transfer({
govPool: "0x...",
token: "0x...",
recipient: "0x...",
amount: "1000000000000000000"
})
```
每个写入工具返回一个`TxPayload`，您将其传递给钱包。 要让服务器广播，请通过WalletConnect连接钱包（`dexe_wc_connect`）或设置`DEXE_PRIVATE_KEY`； 这启用了复合流程`dexe_proposal_create`、`dexe_proposal_vote_and_execute`和`dexe_tx_send`.
## 要求
- 节点.js ≥ 20 并且有可用的`npm`。
- Git — 仅用于可选的开发工具集（`dexe_compile` / `dexe_test` / `dexe_lint`），它在首次使用时浅克隆DeXe-Protocol。设置`DEXE_PROTOCOL_PATH`以使用现有的检查点。 读取、构建和部署不使用它。
## 功能
- DeXe 治理覆盖：33种提案类型（24种外部，4种内部验证器，5种链下），验证器室，专家委托，多层场外销售，带有默克尔白名单。
- calldata优先的密钥模型：任何构建工具都不需要私钥。 广播是一种单独的、明确的选择。
- 零配置读取：公共RPC、subgraph、后端和IPFS网关默认值允许读取工具开箱即用。
- 外部治理支持：18个`dexe_gov_*`工具读取、构建、模拟和解码针对OpenZeppelin和Bravo治理者；新的DAO是一个配置条目。
- 在链上测试：一个59场景的多智能体套件在BSC测试网fixture DAO上锻炼构建者 — 仅构建检查所有提案类型，完整的提案 → 投票 → 执行生命周期用于广播路径。
- MIT许可，无遥测，无托管依赖 — 请求仅发送到您配置的端点。
## 示例应用
验证的、提示级别的场景位于 **[docs/USE_CASES.md](https://github.com/edward-arinin-web-dev/dexe-mcp/blob/main/docs/USE_CASES.md)** — 每个场景都有它所锻炼的精确工具和链上证据。 亮点：
- **基础知识** — 一次调用创建带有自己的代币的DAO；提案 → 投票 → 执行；加入现有的DAO。
- **实时数据问答** — “DAO X有验证者吗？”，鲸鱼地图，TVL图表，委托图，每个提案的投票者列表。
- **自动化** — 将读取与代理的调度器（`/loop`，`/schedule`）配对：提案监视器，每日治理摘要（`dexe_user_inbox`），法定人数跟踪器， treasury 监视器，基于策略的委托代理。
- **分析** — 解码 + 风险评估任何提案（法定人数安全性， treasury 处于风险之中，谁获利）；在购买前对DAO进行尽职调查；模拟后再广播。
- **高级操作** — 使DAO调用任何外部合约（`custom_abi`），场外销售，跨DAO委托（一个DAO在另一个DAO内投票 — 主网实时），外部治理DAO，Safe多签。
## 工具目录
19组165种工具。 完整的工具参考和所需的环境变量：[docs/TOOLS.md](https://github.com/edward-arinin-web-dev/dexe-mcp/blob/main/docs/TOOLS.md).
默认会话加载`core,proposals`配置文件（~72种工具），以保持MCP工具列表较小。 设置`DEXE_TOOLSETS=full`以获取所有工具，或根据需要添加配置文件（`read`、`vote`、`governor`、`dev`）— 参见 [工具集配置文件](https://github.com/edward-arinin-web-dev/dexe-mcp/blob/main/docs/TOOLS.md#toolset-profiles). 在会话中首先调用`dexe_context`：它返回签名者、活动链、环境准备情况以及在前几会话中记录的DAO/提案。
| 分组 | 工具 | 概要 |
|-------|-------|---------|
| 开发工具 | 4 | DeXe-Protocol工作区的Hardhat生命周期：`dexe_compile`，`_test`，`_coverage`，`_lint`。 |
| 合约内省 | 10 | 列出合约，获取ABI，查找选择器，读取NatSpec和源，解码calldata和提案有效载荷。 |
| DAO读取 | 32 | DAO信息，提案状态/列表/投票者，投票权， treasury ，设置，验证者，质押，分布，风险评估，协议范围的统计数据，以及subgraph查询（DAO列表，成员，专家，委托映射，用户活动，自由格式`dexe_graph_query`）。 |
| 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 | 命名构建器：代币转移/分配/销售， treasury 提取，验证者，专家，质押层，黑名单，配置文件更改，投票设置等。 |
| 内部验证器包装器 | 4 | 验证器室提案：余额，设置，每月提取，链下内部。 |
| 链下包装器和身份验证 | 8 | DeXe后端集成：SIWE登录，链下提案创建和投票。 |
| 投票，质押，委托，执行，认领构建器 | 26 | `GovPool`和`Validators`的直接EOA写入：存款，投票，委托，执行，认领，质押，代币销售购买/认领，多调用。 |
| 复合签名流程 | 8 | `dexe_proposal_create`，`dexe_proposal_vote`，`dexe_tx_send`，e_tx_status`，`dexe_get_config`，`dexe_context`，加上v0.28代理密钥环dexe_agents_list`，`dexe_agents_f）。 |
| 默克尔实用程序 | 2 | `_merkle和`dexele_proof`，与OZ `StandardMerkleTree`兼容。 |
| 场外交易综合体 | 4 | 打开多层销售，检查买家状态，购买（原生或带有默克尔证明），认领已兑现的付款。 [docs/OTC.md](./docs/OTC.md) |
| Safe多签 | 2 | 在Safe交易服务中排队交易，而不是广播。 [docs/SAFE.md](./docs/SAFE.md) |
| 模拟器 | 3 | `eth_call`预飞行带有解码的恢复原因：`_sim_calldata`，`_sim_proposal`，`_sim_buy`。 [docs/SIMULATOR.md](./docs/SIMULATOR.md) |
| 多DAO收件箱 + 预测 | 2 | 跨N个DAO的待处理项目（`dexe_user_inbox`）和法定人数预测通过率。 [docs/INBOX.md](./docs/INBOX.md) |
| 外部治理DAO | 18 | `dexe_gov_*`：具有家族意识的提案/投票/排队/执行/委托，干燥运行，投票收据，OZ和Bravo治理者的解码。 [docs/GOVERNOR.md](./docs/GOVERNOR.md) |
| WalletConnect | 3dexe_wc_connect`（配对二维码），`dexe_wc_status`，`dexe_wc_disconnect`。 交易在签名。 [docs/WALLETCON](./docs/WALLE.md) |
| 诊断 | 1 | `dexe`：在配置的环境上运行可达并打印补救提示。 |
## 环境变量
启动服务器不需要任何变量；需要的工具如果缺少变量，则会失败并显示设置名称的消息。[docs/ENVIRONMENT.md](./ENVIRONMENT.md).
| 变量 | 用途 | 备注 |
|----------|----------|-------|
| `_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回退。 |
| `DEXE_PINATA_JWT` | IPFS上传 | 创建DAO/提案（元数据固定）所需。 |
| `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。 |
| `DEXE_PRIVATE_KEY` | 广播模式 | 热密钥签名。 可选；优先使用WalletConnect。 构建工具从不要求。 |
| `DEXE_TOOLSETS` | 工具门控 | 配置文件列表；默认为`core,proposals`。 |
| `DEXE_SUBGRAPH_POOLS_URL` / `_VALIDATORS_URL` / `_INTERACTIONS_URL` | subgraph读取 | The Graph端点；默认为去中心化网络。 |
| `DEXE_GRAPH_API_KEY` | subgraph读取仅当URL未嵌入密钥时。 |
| `DEXE_BACKEND_API_URL` | 链下提案 | DeXe后端，例如`https://api.dexe.io`。 |
| `DEXE_STATE_PATH` | 持久性 | 覆盖会话状态文件（`~/.dexe-mcp/state.json`）。 |
| `DEXE_PROTOCOL_PATH 开发工具集 |DeXe-Protocol检查点；禁用自动克隆。 |
## 文档
- [docs/USE_CASES.md](./docs/USE_CASES.md) — 验证的用例目录：要对代理说什么，发生了什么，链上证据。
- [docs/PLAYBOOKdocs/PLAYBOOK.md) — AI手册：意图 → 确切调用，按类型参数，错误 → 补救。 也作为MCP资源e://playbook`提供。
- [docs/TOOLS.md](./docs/TOOLS — 所有165种工具，按组列出，附有一句话描述和所需的环境变量。
- [docs/USAGE.md](./docs/USAGE.md) — 复制粘贴的JSON示例。
- [docs/ENVIRONMENT.md](./docs/ENVIRONMENT.md) — 完整的环境变量参考和常见陷阱。
- [docs/INSTALL.md](./docs/INSTALL.md) — 每个MCP客户端的安装说明。
- [docs/SETUP.md](./docs/SETUP.md) / [docs/DOCTOR.md](./docs/DOCTOR.md) — 设置向导和诊断参考。
- [docs/SKILLS.md](./docs/SKILLS.md) — 随软件包提供的Claude Code技能。
- [docs/GRAPH.md](./docs/GRAPH.md) — `dexe_graph_query`的subgraph实体参考（pools / interactions / validators）。
- [docs/GOVERNOR.md](./docs/GOVERNOR.md) — 外部OZ/Bravo治理接口。
- [docs/WALLETCONNECT.md](./docs/WALLETCONNECT.md) — 无热键的手机批准签名。
- [docs/OTC.md](./docs/OTC.md) — 多层场外交易销售流程适用于所有者和买家。
- [docs/PROFILE.md](./docs/PROFILE.md) — DAO配置文件和头像管道。
- [docs/SIMULATOR.md](./docs/SIMULATOR.md) — 预飞行模拟带有恢复解码。
- [docs/INBOX.md](./docs/INBOX.md) — 跨DAO收件箱和提案预测。
- [docs/MIGRATION.md](./docs/MIGRATION.md) — 每个版本的升级说明。
## 群体测试套件
[`tests/swarm/`](./tests/swarm) 是一个多智能体套件，在真实的BSC测试网DAO上锻炼工具表面：59个JSON场景，涵盖委托链，验证器室，构建检查仅适用于每种提案类型，OTC流程和完整的广播生命周期。 协调器解析代理钱包并通过内联ethers调度器或`dexe-mcp`stdio桥运行每个步骤。
```bash
npm run swarm:preflight # 每钱包就绪表
npm run swarm:fund -- --confirm # 从资助者那里补充
npm run swarm:run # 完整扫描
npm run swarm -- --scenarios=S00-reset --dry-run
```
设置操作手册：[tests/swarm/README.md](./tests/swarm/README.md) · 场景模式：[tests/swarm/scenarios/_schema.md](./tests/swarm/scenarios/_schema.md) · 代理提示：[tests/swarm/prompts/](./tests/swarm/prompts).
## 贡献
```bash
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 # 监视模式
```
问题，PR和提案类型请求： [ issues](https://github.com/edward-arinin-web-dev/dexe/issues).
## 安全
参阅 [SECURITY.md](./SECURITY.md) 获取威胁模型，策略和如何报告漏洞。 简而言之：
- 发布标签由GPG签名；`` 在发布前运行`git verify-tag`。 使用维护者密钥导入后本地验证 `git verify-tag <tag>` （例如 `v0.19.0`）。
- npm版本发布使用 `--provenance` 发布；使用 `npm audit signatures` 验证。
- CI从提交的锁定文件严格安装，并在漂移时失败。
- 代码QL，OSSF Scorecard和Dependency Review在PR和计划上运行。
## 许可
MIT。 参见 [LICENSE](./LICENSE).
---
<p align="center">
<sub>DeXe 协议治理栈的独立开源集成。 不隶属于DeXe Network。</sub>
</p>
