wdk-mcp

WDK MCP

专为钱包开发设计的本地优先MCP服务器。提供种子和钱包管理、余额读取以及交易发送——所有操作都在您的机器上进行。您可以选择通过ngrok公开MCP端点以供远程LLM使用。种子短语永远不会离开您的机器。 🔒

功能

• 种子管理：创建、读取、更新、删除；钱包引用种子
• 钱包管理：创建、列出、读取、更新、删除；添加地址
• 余额：通过配置的网络获取地址余额
• 交易：从托管的钱包发送交易
• 本地优先：状态存储在项目根目录下的wdk-data.json中
• 隐私：种子短语不会发送给LLM或远程服务
• 可选ngrok：公开http://localhost:8080/mcp给远程LLM提供商

要求

• Bun（推荐最新版本）
• 可选：如果您需要远程访问，请设置NGROK_AUTHTOKEN

安装

# 安装依赖
bun install

# （可选）设置ngrok认证令牌以公开访问
export NGROK_AUTHTOKEN="<your-token>"

运行

# 启动MCP服务器
bun run src/index.ts

服务器将在http://localhost:8080/mcp监听。

Web UI（可选）

包含一个轻量级Next.js仪表板用于管理和查看种子及钱包。 🖥️

cd src/webui
bun install
bun run dev

然后打开http://localhost:3000。

验证

• 启动时您应该看到一条横幅和一行信息：FastMCP服务器正在运行于http://localhost:8080
• 数据文件路径记录为：数据库已准备好：<path>/wdk-data.json

数据模型

• 存储在wdk-data.json中
• 顶级键：seeds，wallets，apiKeys
• 设计用于本地开发；简单的JSON存储

工具参考

• create_seed：创建一个新的种子条目

• list_seeds：列出所有种子

• get_seed：根据ID获取种子

• update_seed：更新种子元数据/短语

• delete_seed：移除一个种子

• create_wallet：创建与种子关联的钱包

• list_wallets：列出所有钱包

• get_wallet：根据ID获取钱包

• add_wallet_address：将地址附加到钱包

• update_wallet：更新钱包元数据

• delete_wallet：移除一个钱包

• get_balance：获取特定地址的余额

• send_transaction：从钱包发送交易

• set_api_key：本地存储API密钥

• get_api_key：检索存储的API密钥

• list_api_keys：列出存储的API密钥

• delete_api_key：删除API密钥

• get_database_stats：基本计数和配置路径

限制

• 数据存储是一个普通的JSON文件，并且目前未加密 ⚠️
• 仅支持EVM/ETH流程；其他链不支持
• 没有桥接或跨链协议
• 基本RPC提供者配置；没有高级重试/回退逻辑
• 验证简单；仅限开发环境使用

备注

• 使用Bun执行所有脚本和操作。
• 如果端口8080已被占用，请停止其他进程或更改src/index.ts中的端口。