AI导哈

去中心化交易服务器

Kuru Exchange MCP Server是一个用于通过Kuru SDK与Kuru交易所交互的模型上下文协议服务器，使AI代理能够在Monad区块链上执行DeFi交易操作。

  • by KodeusAI
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 KodeusAI/kuru-mcp-server

使用说明

Kuru Exchange MCP 服务器

由……建造/建成 KodeusAI（可译为“科德斯AI”或保持原样，具体取决于品牌或项目对名称的官方翻译要求） - 开放代理操作系统

为实际工作而建，链上应用

一个模型上下文协议（MCP）服务器，用于通过Kuru SDK与Kuru交易所进行交互。该服务器通过与Claude Desktop集成，使AI代理能够在Monad区块链上执行DeFi交易操作。

🚀 功能特性

  • Kuru SDK 集成与 @kuru-labs/kuru-sdk 完全集成
  • 钱包管理从私钥获取钱包地址
  • 环境验证验证必需的环境变量
  • 链配置对Monad区块链的支持
  • 安全的无需.env文件依赖 - 直接使用环境变量
  • AI代理就绪与Claude桌面版无缝集成

由KodeusAI构建

这个MCP服务器是由……开发的 KodeusAI（这个名称本身可能是一个特定产品或服务的名称，直接翻译可能无实际意义，但若按字面结构尝试翻译，可大致理解为“科德斯人工智能”，不过具体含义需结合上下文或官方解释）Kodeus，一个开放代理操作系统，能够将用户意图转化为实际的链上执行。它赋能用户创建、部署并进化智能代理，这些代理能够在链上和链下堆栈之间无缝运行。

Key Kodeus 的主要功能：

  • 🧠 这个符号通常代表“大脑”或“思考”，在中文中可以翻译为“大脑”或根据上下文翻译为“思考中”、“智慧”等。 可组合代理框架面向真实代理的模块化、去中心化框架
  • 🔗（链接符号，无直接对应中文翻译，通常表示链接或连接） Web3集成与领先的Web3协议无缝集成
  • 💰 边建设边赚钱用$KODE代币实现您的代理贡献变现
  • 🛠️（工具箱或维修工具的象征） **开发者软件开发工具包（SDK）**构建自定义MCP模块和工作流

📦 设置

先决条件

  • Node.js 版本 >= 18.0.0
  • npm 或 yarn

安装

  1. 克隆或导航到项目目录：
cd kuru-mcp-server
  1. 安装依赖项：
npm install
  1. 在运行服务器时设置所需的环境变量：
PRIVATE_KEY=your_private_key_here
KURU_API_URL=https://api.testnet.kuru.io
RPC_URL=https://rpc.ankr.com/monad_testnet

重要的请将值替换为您的实际配置。

建筑

构建TypeScript项目：

npm run build

跑步

使用环境变量启动MCP服务器：

PRIVATE_KEY=your_private_key KURU_API_URL=https://api.testnet.kuru.io RPC_URL=https://rpc.ankr.com/monad_testnet npm start

或者使用启动脚本：

PRIVATE_KEY=your_private_key KURU_API_URL=https://api.testnet.kuru.io RPC_URL=https://rpc.ankr.com/monad_testnet ./start.sh

Claude桌面集成

Claude 桌面版的设置

要在Claude Desktop中使用此MCP服务器，请将以下配置添加到您的Claude Desktop设置中：

  1. 打开Claude桌面设置

    • 在 macOS 上： Claude Desktop → Preferences → Advanced
    • 在Windows上： File → Settings → Advanced

  2. 添加MCP服务器配置 将此配置添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "kuru-exchange": {
      "command": "node",
      "args": [
        "<Path to MCP>/build/index.js"
      ],
      "env": {
        "KURU_API_URL": "https://api.testnet.kuru.io",
        "RPC_URL": "https://rpc.ankr.com/monad_testnet",
        "PRIVATE_KEY": "<Your Wallet Private Key>"
      }
    }
  }
}

  1. 替换占位符

    • <Path to MCP>到您的kuru-mcp-server目录的完整路径
    • <Your Wallet Private Key>您的实际私钥（请妥善保管！）

  2. 示例配置

{
  "mcpServers": {
    "kuru-exchange": {
      "command": "node",
      "args": [
        "/Users/username/kuru-mcp-server/build/index.js"
      ],
      "env": {
        "KURU_API_URL": "https://api.testnet.kuru.io",
        "RPC_URL": "https://rpc.ankr.com/monad_testnet",
        "PRIVATE_KEY": "0x1234567890abcdef..."
      }
    }
  }
}

  1. 重启Claude桌面版

    • 关闭并重新打开Claude Desktop以使更改生效

  2. 验证连接

    • 在Claude Desktop中，你应该能看到“kuru-exchange”作为一个可用工具
    • 测试语句：“我的钱包地址是什么？”或“获取链信息”

Claude桌面版的安全注意事项

  • 永远不要分享你的私钥 - 保持其安全
  • 仅使用测试网 - 这是用于测试目的
  • 备份您的配置 - 为你的配置文件保留一份安全的备份
  • 监控交易 - 在确认交易前务必核实

🛠️ 可用工具

获取钱包地址

从存储的私钥中派生出钱包地址 PRIVATE_KEY 环境变量。

参数无

示例回复：

💰 Wallet Address:

• Address: 0x1234567890abcdef...
• Derived from: PRIVATE_KEY environment variable
• Chain: Monad Testnet (10143)
• RPC URL: https://rpc.ankr.com/monad_testnet
• Kuru API: https://api.testnet.kuru.io
• Status: ✅ Ready for Kuru exchange operations

💡 Usage: This address can be used for trading operations on Kuru exchange.

获取链信息

获取有关已配置区块链网络的信息。

参数无

获取所有池（或：获取所有资源池/数据池等，具体含义取决于上下文）

使用PoolFetcher获取某代币对的所有可用流动性池。

参数：

  • tokenIn (字符串)：输入代币地址
  • tokenOut (字符串)：输出代币地址

查找最佳路径

使用PathFinder找到代币交换的最佳路径。

参数:

  • tokenIn (字符串)：输入代币地址
  • tokenOut (字符串)：输出代币地址
  • amount (数字)：要兑换的数量（以数字格式表示，而非ERC20小数格式）
  • amountType （字符串，可选）：金额类型：'amountIn'（输入金额）或 'amountOut'（输出金额）（默认：amountIn）

估计兑换输出

估算代币兑换的输出量。

参数：

  • tokenIn (字符串)：输入代币地址
  • tokenOut (字符串)：输出代币地址
  • amountIn (数字)：输入数量（以数字格式表示，非ERC20小数格式）

执行交换

使用路由合约执行代币交换，同时自动检测小数位数并检查授权。

参数:

  • tokenIn （字符串）：输入代币地址
  • tokenOut (字符串)：输出代币地址
  • amount (数字)：要兑换的金额（以数字格式表示，非ERC20小数位格式）

获取令牌信息

获取有关ERC20代币的详细信息。

参数:

  • tokenAddress (字符串): 代币合约地址

获取可用基础代币

获取可用于创建池的可用基础代币列表。

参数无

🌐 支持的网络

  • Monad 测试网 （链ID：10143）- 目前唯一可用的网络
    • 浏览器：https://testnet.monadexplorer.com
    • RPC（远程过程调用）地址：https://rpc.ankr.com/monad_testnet
    • 状态：✅ 活跃测试网

🔧 开发

开发模式

以开发模式运行，并启用TypeScript编译以监视更改：

npm run dev

测试

运行测试：

npm test

📋 环境变量

变量 描述 必需 默认值
中文翻译 中文对应内容 中文翻译 中文对应内容
钱包操作的私钥 是 - KURU_API_URL
Kuru API终端点URL 是 - RPC_URL
区块链RPC终端URL 是 - CHAIN_ID

| 链表ID（可选） | 否 | 10143 |

  • 🔐 安全注意事项
  • 无需.env文件依赖 - 环境变量直接传递
  • 确保您的私钥安全，切勿与他人共享
  • 私钥仅用于推导钱包地址并初始化Kuru客户端

所有敏感数据均通过环境变量进行安全处理

🤝 贡献

  1. **这个项目是Kodeus生态系统的一部分。要参与贡献：**构建自定义MCP模块
  2. 开发并托管符合MCP标准的服务器代理开发
  3. 使用Kodeus开发者SDK来构建智能代理社区

加入Kodeus社区，通过贡献赚取$KODE代币 了解更多，请访问

KodeusAI（可译为“科德斯AI”或根据具体语境调整为更贴切的名称）

📄 许可证

Built with ❤️ by KodeusAI

The Open Agentic Operating System for Web3

相关 MCP