Crynux MCP

Crynux MCP服务器

 ](https://pypi.org/project/crynux-mcp/)

用于Crynux网络操作的MCP服务器，专为LLM客户端（如Cursor、VS Code和Claude Desktop）设计，通过标准化的MCP工具执行大多数Crynux Network/Crynux Portal操作。

特性

钱包

• 使用系统钥匙链进行钱包管理（创建密钥、签署交易、列出/删除/导出密钥、设置默认密钥）

区块链

• Crynux L2网络上的原生CNX余额查询
• Crynux L2网络上最新的块高度查询
• 本地CNX转账
• 受益地址查询和链上更新
• 节点质押查询
• 节点信用查询

中继

• 中继账户余额查询
• 中继撤销创建/列表/最新状态查询
• 中继存款发起/列表/最新状态查询

工具

有关完整的操作列表和详细的输入/输出字段，请参阅 docs/tools.md.

安全说明

• 服务器从不故意记录原始私钥。
• transfer_native 从本地系统密钥链读取签名者密钥。
• 可选回退：如果不存在密钥链条目，则读取 CRYNUX_PRIVATE_KEY 来自MCP服务器环境。
• 该模型只看到传输字段(network, to, amount，以及可选的气田），而不是原材料。
• 使用专用的低风险钱包进行人工智能操作，而不是国库钱包。

开始使用

步骤1）先决条件

• 安装Python 3.11或更高版本。
• 打开终端。

步骤2）安装软件包

从PyPI安装（推荐）：

python -m pip install crynux-mcp

如果您正在开发此存储库，请在可编辑模式下从源代码安装：

python -m pip install -e ".[dev]"

步骤3）选择您的AI客户端并添加MCP配置

您只需要一个客户端配置（Cursor、VS Code或Claude Desktop）。

光标

创建或编辑 .cursor/mcp.json 在您的项目中：

{
  "mcpServers": {
    "crynux-mcp": {
      "command": "python",
      "args": ["-m", "crynux_mcp"]
    }
  }
}

VS Code

创建或编辑 .vscode/mcp.json 在您的项目（或您的用户）中 mcp.json):

{
  "servers": {
    "crynuxMcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "crynux_mcp"]
    }
  }
}

克劳德桌面版

编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "crynux-mcp": {
      "command": "python",
      "args": ["-m", "crynux_mcp"]
    }
  }
}

步骤4）管理签名者密钥（跨平台）

在终端中运行以下命令：

crynux-mcp key add --name main
crynux-mcp key create --name trading-bot
crynux-mcp key list
crynux-mcp key set-default --name main
crynux-mcp key delete --name trading-bot

key add 提示输入隐藏的私钥，并将其存储在操作系统钥匙链中。 key create 生成一个新的私钥并将其直接存储在您的操作系统密钥链中。

• Windows:凭据管理器
• macOS：钥匙扣
• Linux：与特勤局兼容的密钥环

可选的高级回退（如果您不需要密钥链）：set CRYNUX_PRIVATE_KEY 在MCP服务器环境中。

步骤5）重新启动AI客户端

保存MCP配置后，完全重新启动客户端，以便重新加载服务器。

步骤6）验证服务器是否已加载

在您的AI客户端中，检查MCP工具列表，确认钱包、区块链和Relay操作可用。 使用 docs/tools.md 作为完整行动目录的真相来源。

步骤7）第一次工具调用

示例：查询余额

• network: dymension
• address：您的EVM地址
• unit: ether

示例：发送本地CNX

• network: dymension
• key_name: main （可选，如果省略，则使用默认本地密钥）
• to：收件人EVM地址
• amount：例如 0.1
• unit: ether

示例：查询中继账户余额

• network: dymension
• address：您的钱包EVM地址
• key_name: main （可选）

获取中继身份验证令牌，并在内部刷新以进行身份验证的中继操作。

示例：创建中继撤回请求

• network: dymension
• address：您的钱包EVM地址
• amount_wei：例如 1000000000000000000 （1 CNX）
• benefit_address：可选目标地址
• key_name: main （可选）

示例：启动中继存款（链上转账）

• network: dymension
• amount：例如 1
• unit: ether
• key_name: main （可选）

用于传输的签名者密钥源：

• 系统钥匙链中的命名钥匙由以下人员设置 crynux-mcp key add 或 crynux-mcp key create （首选）
• CRYNUX_PRIVATE_KEY 一个是退路

步骤8）可选的本地手动运行

您可以直接启动MCP服务器进程进行调试：

python -m crynux_mcp

规格和运输

• MCP协议目标： 2025-11-25
• 运行时传输： stdio （本地进程，不需要HTTP服务器）

发布

维护人员发布说明见 RELEASE.md.

网络配置

链元数据存储在：

• src/crynux_mcp/config/chains.json

更新此文件以更改RPC URL、链ID或合约地址。

中继API配置存储在：

• src/crynux_mcp/config/relay.json

更新此文件以更改中继URL、超时和每个网络的存款地址。

测试

pytest