AI导哈

区块链AI代理服务器

KAIA-MCP Server是一个连接AI代理与KAIA区块链上DeFi协议的基础设施，支持多协议交互、智能钱包管理和实时市场数据分析。

  • by tamago-labs
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 tamago-labs/kaia-mcp

使用说明

KAIA-MCP服务器

Kaia生态系统的AI×DeFi基础设施

这 KAIA-MCP服务器 使能够 AI代理 直接与DeFi协议交互 Kaia区块链.
建立在 模型上下文协议（MCP），它连接了以下工具 克劳德桌面 或 Cursor.ai 实时区块链数据和交易执行。

特性

多协议支持

  • 贷款： KiloLend（复合v2分叉）用于供应、借用和偿还
  • DEX： DragonSwap V3用于报价和掉期
  • API价格： CoinMarketCap和CoinGecko API实时代币价格
  • 人工智能管理的保险库： 自动化跨协议策略以提高产量 （计划中）
  • 市场情报： 实时APY、利用率和TVL
  • 智能钱包： 统一的位置和平衡跟踪

与Claude Desktop一起使用

  1. 如果您还没有安装Claude Desktop，请安装
  2. 打开克劳德桌面设置
  3. 将KAIA MCP客户端添加到您的配置中：
{
  "mcpServers": {
    "kaia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tamago-labs/kaia-mcp"
      ],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "transaction",
        "KAIA_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      },
      "disabled": false
    }
  }
}

代理模式

只读模式（默认）

  • 目的：没有交易功能的安全探索和数据分析
  • 用例：非常适合研究、市场分析和监控头寸
  • 能力：查询市场数据，检查钱包余额，监控头寸，获取掉期报价
  • 安全：无需私钥-数据访问完全安全
  • 配置：设置 KAIA_AGENT_MODE “只读”或省略私钥

交易模式

  • 目的：具有执行事务能力的完整DeFi操作
  • 用例：主动交易、借贷和投资组合管理
  • 能力：所有只读功能加上执行交易、供应/借用资产、转移代币、执行DEX掉期
  • 安全：需要 KAIA_PRIVATE_KEY -确保密钥管理安全
  • 配置：设置 KAIA_AGENT_MODE “交易”并提供有效的私钥

建筑

此MCP服务器遵循为多协议支持而设计的干净、模块化架构：

src/
├── agent/
│   └── wallet.ts            # Unified WalletAgent for all operations
├── mcp/                     # MCP tool definitions and implementations
│   ├── index.ts             # Main MCP server entry point and tool registry
│   ├── kilolend/           # KiloLend protocol tools
│   ├── dragonswap/          # DragonSwap V3 protocol tools
│   ├── price-api/          # Price API tools for token prices
│   └── wallet/              # General wallet operations
├── tools/                  # Core utility functions
│   └── price-api/          # Price API core functions
├── contracts/               # Smart contract interfaces and ABIs
│   ├── comptroller.ts       # KiloLend Comptroller contract
│   ├── ctoken.ts           # KiloLend cToken contracts
│   ├── erc20.ts            # Standard ERC-20 interface
│   ├── wkaia.ts            # WKAIA contract interface
│   └── dragonswap/         # DragonSwap contract ABIs
├── utils/                  # Utility functions and helpers
│   ├── errors.ts           # Error handling classes
│   ├── formatting.ts       # Token amount formatting utilities
│   └── validation.ts       # Input validation functions
├── config.ts               # Configuration management and environment setup
├── types.ts                # TypeScript type definitions
└── index.ts                # Main server entry point

安装

npm install
npm run build

配置

环境变量

创建一个 .env 文件基于 .env.example:

# Required
KAIA_RPC_URL="https://public-en.node.kaia.io"         # KAIA Mainnet RPC URL

# Optional
KAIA_PRIVATE_KEY="your_private_key_here"             # Wallet private key (for transaction mode)
KAIA_AGENT_MODE="readonly"                           # "readonly" or "transaction" (defaults to readonly)
KAIA_NETWORK="kaia"                                  # Network (only kaia supported currently)

可用工具

钱包工具

只读工具

工具 说明
get_wallet_info 获取钱包信息和代币余额

交易工具

工具 说明
send_native_token 发送本地KAIA代币
send_erc20_token 发送ERC-20代币
wrap_kaia 将KAIA包裹到WKAIA
unwrap_kaia 将WKAIA拆分为KAIA
check_allowance 检查操作的令牌容差
approve_token 批准操作令牌

KiloLend工具

只读工具

工具 说明
get_account_liquidity 检查账户流动性和健康因素
get_markets 获取所有贷款市场的利率
get_protocol_stats 获取协议统计数据和TVL

交易工具

工具 说明
enter_market 进入市场以启用抵押品使用
supply_to_market 向贷款市场供应资产
borrow_from_market 从贷款市场借款
repay_borrow 偿还借入头寸
redeem_tokens 兑换cTokens（按cToken金额提取）
redeem_underlying 兑换基础代币（按基础金额提取）

API工具价格

只读工具

工具 说明
get_all_prices 从KiloLend price API获取所有可用价格
get_token_prices 获取特定代币的价格（例如[“KAIA”、“BTC”、“ETH”]）
get_kaia_ecosystem_prices 仅获取KAIA生态系统代币价格（KAIA、BORA、MBX、SIX、SOMNIA、stKAIA）
get_major_crypto_prices 获取主要加密货币价格（BTC、ETH）
get_quick_prices KAIA、BTC和ETH的快速价格概述

DragonSwap工具

只读工具

工具 说明
dragonswap_get_pool_info 获取DragonSwap池信息
dragonswap_get_swap_quote 无需执行即可获取掉期报价
dragonswap_get_route 获取交换的最佳路由路径（支持多跳）

交易工具

工具 说明
dragonswap_execute_swap 在DragonSwap上执行代币交换

支持的代币

KiloLend支持的代币

  • 卡娅：本地KAIA代币
  • 泰达币：Tether美元(0xd077a400968890eacc75cdc901f0356c943e4fdb)
  • 六：六个令牌(0xEf82b1C6A550e730D8283E1eDD4977cd01FAF435)
  • 宝拉：BORA代币(0x02cBE46fB8A1F579254a9B485788f2D86cAD51aa)
  • 马里博尔：大理石令牌(0xD068c52d81f4409B9502dA926aCE3301cc41f623)
  • stKAIA：Lair抵押KAIA(0x42952B873ed6f7f0A7E4992E2a9818E3A9001995)

DragonSwap支持的代币

  • 卡娅：本地令牌
  • WKAIA：包装好的KAIA(0x19aac5f612f524b754ca7e7c41cbfa2e981a4432)
  • 泰达币：官方USDT(0xd077a400968890eacc75cdc901f0356c943e4fdb)
  • 泰达币：虫洞USDT(0x5c13e303a62fc5dedf5b52d66873f2e59fedadc2)
  • 宝拉：BORA代币(0x02cBE46fB8A1F579254a9B485788f2D86cAD51aa)
  • 马里博尔：大理石令牌(0xD068c52d81f4409B9502dA926aCE3301cc41f623)
  • stKAIA：Lair抵押KAIA(0x42952B873ed6f7f0A7E4992E2a9818E3A9001995)

未来协议支持

我们正在积极努力增加对以下内容的支持：

  • 附加贷款协议：更多贷款平台
  • 质押协议：流动性质押和Lair Finance整合
  • 跨链消息传递：用于跨链操作的Chainlink CCIP
  • 高产农业：跨协议产量优化

合同地址

Kaia主网

KiloLend（化合物v2）

  • 审计长: 0x0B5f0Ba5F13eA4Cb9C8Ee48FB75aa22B451470C2
  • 市场:
    • cUSDT： 0x498823F094f6F2121CcB4e09371a57A96d619695
    • cSIX ： 0xC468dFD0C96691035B3b1A4CA152Cb64F0dbF64c
    • cBORA: 0x7a937C07d49595282c711FBC613c881a83B9fDFD
    • cMBX： 0xE321e20F0244500A194543B1EBD8604c02b8fA85
    • 凯亚： 0x98Ab86C97Ebf33D28fc43464353014e8c9927aB3
    • cStKAIA： 0x0BC926EF3856542134B06DCf53c86005b08B9625

DragonSwap V3

  • 路由器: 0xA324880f884036E3d21a09B90269E1aC57c7EC8a
  • 报价器V2: 0x673d88960D320909af24db6eE7665aF223fec060
  • 工厂: 0x7431A23897ecA6913D5c81666345D39F27d946A4

故障排除

如果你使用的是Ubuntu或其他带有NVM的Linux环境，你需要手动配置路径。请按照以下步骤操作：

  1. 在当前NVM管理的Node.js版本下安装KAIA MCP。
npm install -g @tamago-labs/kaia-mcp
  1. 由于NVM安装库的方式，您可能需要在配置中使用绝对路径。将以下示例值替换为您的实际用户名和节点版本：
{
  "mcpServers": {
    "kaia-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/kaia-mcp"
      ],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "transaction",
        "KAIA_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}
  1. 重新启动Claude Desktop，它现在应该可以工作了。

环境变量问题

如果遇到无法识别环境变量的问题：

  1. 检查所需变量：确保 KAIA_RPC_URL 始终设置
  2. 验证模式设置: KAIA_AGENT_MODE 应该是“只读”或“事务”
  3. 私钥格式: KAIA_PRIVATE_KEY 必须是64个十六进制字符（带或不带0x前缀）
  4. 调试记录：服务器将在启动时将所有配置记录到stderr

使用本地文件

在处理本地文件时，特别是在使用KAIA CLI工具进行智能合约开发以在您的计算机上创建、构建和测试Move包时，您需要导入一个额外的MCP服务器库 filesystem 由克劳德团队制作。配合使用：

"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "${workspaceFolder}"
  ],
  "env":{
        
  },
  "disabled": false
}

workspaceFolder 指您的工作目录。你可以提供多个论点。然后可以在AI提示中引用子文件夹或特定文件。

如果您使用的是Linux，在安装过程中遇到问题，请参阅故障排除部分。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP