AI导哈

DeFi集成服务器

KawaFi是一个基于Hedera区块链的DeFi集成服务器，通过Model Context Protocol (MCP)提供对多个DeFi平台的统一访问，支持数据分析和交易准备功能。

  • by gabrielantonyxaviour
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gabrielantonyxaviour/kawa-fi

使用说明

KawaFi-Hedera DeFi MCP服务器

KawaFi 通过模型上下文协议（MCP）提供对Hedera DeFi生态系统的统一访问，使AI助手能够安全有效地与多个DeFi平台进行交互。

🚀 概述

一个全面的模型上下文协议（MCP）服务器，提供对主要Hedera DeFi平台的统一访问，包括SaucerSwap、Bonzo Finance、Stader、HeliSwap和Hashport。该服务器使AI助手和应用程序能够通过以下方式与Hedera的DeFi生态系统进行交互 36个标准化工具 涵盖数据分析、交易准备和跨平台操作。

✨ 特性

🔐 双模安全系统

  • 准备模式 （默认）：生成未签名的交易以供外部签名
  • 执行模式 （高级）：可选择直接签署和执行交易
  • 安全第一设计：私钥仅在明确需要时加载

🌐 多平台DeFi集成

🛠️ 综合工具集

  • 数据与分析：实时价格、池储备、APY、贷款利率
  • 交易准备：使用正确的编码完成未签名的交易数据
  • 跨链运营：跨多个网络的资产桥接
  • 成品率优化：抵押、耕种和贷款机会

📊 工具概述

平台 数据工具 交易工具 总计 状态
SaucerSwap 10 9 19 ✅ 100%工作
邦佐金融 3 0* 3 ✅ 100%工作
施塔德 1 2 3 ✅ 100%工作
HeliSwap 的 1 0 1 ✅ 100%工作
哈希端口 10 0 10 ✅ 100%工作
总计 25 11 36 ✅ 100%工作

*Bonzo交易工具计划在未来发布

🔧 安装和设置

先决条件

  • Node.js 18+
  • MCP兼容客户端（Claude Desktop等）

1.安装

# Install globally from npm
npm install -g kawa-fi-mcp

# Or run with npx (no installation needed)
npx kawa-fi-mcp --help

2.环境配置

创建一个 .env 使用您所需的配置文件（请参阅 .env.example 供参考）：

# Network Selection
HEDERA_NETWORK=mainnet  # or "testnet"

# Security Mode
EXECUTE_TX=false        # true for execution, false for prepare-only

# Platform API Keys
SAUCERSWAP_API_KEY=your_api_key_here  # Optional but recommended

# Hedera Credentials (choose based on network)
MAINNET_HEDERA_OPERATOR_ID=0.0.your_account
MAINNET_HEDERA_OPERATOR_KEY=your_private_key     # Only if EXECUTE_TX=true
TESTNET_HEDERA_OPERATOR_ID=0.0.your_testnet_account  
TESTNET_HEDERA_OPERATOR_KEY=your_testnet_private_key  # Only if EXECUTE_TX=true

3.MCP客户端配置

添加到您的MCP客户端：

克劳德桌面(claude_desktop_config.json):

{
  "mcpServers": {
    "hedera-defi": {
      "command": "npx",
      "args": ["kawa-fi-mcp"]
    }
  }
}

4.验证

# Test the server directly
npx kawa-fi-mcp

# Or if installed globally
kawa-fi-mcp

# Check available tools (should show 13-36 tools based on configuration)

📋 可用工具

SaucerSwap（19工具）

数据和分析工具（10）

  • saucerswap_get_tokens -所有可用的带有价格和元数据的代币
  • saucerswap_get_stats -平台统计（TVL、交易量、SAUCE流通量）
  • saucerswap_get_sss_stats -单面质押统计和XSAUCE比率
  • saucerswap_get_hbar_prices -历史HBAR价格数据（精细分辨率）
  • saucerswap_get_platform_data -具有时间间隔的历史流动性/交易量数据
  • saucerswap_get_farms -积极的产量农业机会
  • saucerswap_get_farms_by_account -按账户划分的农场LP代币金额
  • saucerswap_get_pools -所有带有储备和代币信息的流动性池
  • saucerswap_get_default_tokens -价格发生变化的默认代币
  • saucerswap_get_v2_pools -具有高级指标（费用、报价、流动性）的V2池

交易工具（9） 🆕

  • saucerswap_quote_exact_input -获取准确输入金额的掉期报价
  • saucerswap_quote_exact_output -获取确切输出金额的掉期报价
  • saucerswap_swap_hbar_for_tokens -准备HBAR→ 代币兑换退款
  • saucerswap_swap_tokens_for_hbar -准备代币→ 带解包的HBAR交换
  • saucerswap_swap_tokens_for_tokens -准备令牌→ 代币互换
  • saucerswap_stake_sauce -为xSAUCE准备SAUCE立桩
  • saucerswap_unstake_xsauce -为SAUCE准备xSAUCE解绑
  • saucerswap_deposit_to_farm -准备LP代币农场存款
  • saucerswap_withdraw_from_farm -准备LP代币农场提款

其他平台工具（17）

邦佐金融（3）

  • bonzo_get_reserves -所有借贷准备金
  • bonzo_get_account -账户头寸和余额
  • bonzo_get_liquidations -符合清算条件的账户

体育场（3）

  • stader_get_exchange_rate -当前HBAR对HBARX汇率
  • stader_stake_hbar -HBARX的HBAR权益（交易）
  • stader_unstake_hbarx -取消HBARX的HBAR（交易）

HeliSwap（1）

  • heliswap_get_pair_info -交易对信息

哈希端口（10）

  • hashport_get_supported_assets -桥梁支持资产
  • hashport_get_supported_networks -所有支持的网络
  • hashport_get_bridge_steps -逐步桥接说明
  • hashport_validate_bridge -验证网桥参数
  • hashport_get_assets_amounts -资产准备金金额
  • hashport_get_transfers -分页传输历史
  • hashport_get_network_assets -特定网络上的资产
  • hashport_get_network_asset_amounts -每个网络的资产金额
  • hashport_get_network_asset_details -详细资产信息
  • hashport_convert_hedera_tx_id -交易ID格式转换

🎯 使用示例

有关所有36个工具的综合示例和测试提示，请参阅 PROMPTS.md.

基本DeFi数据

Get all tokens available on SaucerSwap

Show current HBAR to HBARX staking rate  

List active yield farms with APYs

交易准备🆕

Prepare transaction to swap 10 HBAR for SAUCE tokens with 0.3% fee pool

Prepare transaction to stake 1000000 SAUCE for xSAUCE

Prepare transaction to deposit LP tokens to farm pool 1

分析和跨链

Get HBAR price history from last week

Find accounts eligible for liquidation on Bonzo

Get bridge steps from Ethereum to Hedera for USDC

📊 状态和测试

当前状态

  • 总体：36/36个工具正常工作（成功率100%）
  • 交易工具：11/11工作（成功率100%）
  • 数据工具：25/25工作（100%成功率）

详细结果

看 TEST_RESULTS.md 用于：

  • 完整的测试结果和响应大小
  • 性能说明和API速率限制信息
  • 已知问题和解决步骤
  • 特定于平台的可用性详细信息

已知问题

  • API速率限制：某些SaucerSwap端点在高负载期间可能会超时
  • 网络依赖关系：Stader和HeliSwap仅在主网上可用

🛡️ 安全和交易模式

准备模式（推荐）

EXECUTE_TX=false  # or omit entirely
  • ✅ 安全：私钥从未加载
  • ✅ 灵活的：使用硬件钱包、去中心化应用程序或安全环境进行签名
  • ✅ 透明：提供完整的未签名交易数据
  • ⚡ 快速：没有区块链交互延迟

执行模式（高级）

EXECUTE_TX=true
MAINNET_HEDERA_OPERATOR_KEY=302e020100...
  • ⚠️ 安全：私钥已加载到内存中
  • ⚡ 方便的：自动交易签名和提交
  • 📊 结果：返回交易ID和确认
  • 🎯 用例：自动化战略，可信环境

交易输出示例

准备模式输出：

{
  "type": "prepared_transaction",
  "description": "Swap 10 HBAR for minimum 1000000 SAUCE tokens",
  "from": "0.0.123456",
  "to": "0x00000000000000000000000000000000002cc9B2",
  "function": "multicall(bytes[])",
  "gas": 400000,
  "value": "1000000000",
  "unsigned": {
    "contractId": "0x00000000000000000000000000000000002cc9B2",
    "functionName": "multicall",
    "functionParams": ["0xc04b8d59000000..."],
    "payableAmount": "1000000000"
  }
}

🏗️ 建筑与开发

项目结构

src/
├── clients/           # Platform-specific client implementations
│   ├── saucerswap.ts    # SaucerSwap API + transaction tools
│   ├── bonzo.ts         # Bonzo Finance integration
│   ├── stader.ts        # Stader staking with transactions  
│   ├── hashport.ts      # Hashport bridge operations
│   └── heliswap.ts      # HeliSwap pair data
├── index.ts           # MCP server with 36 tool definitions
└── types/             # TypeScript definitions

开发命令

# For local development (after git clone)
npm install            # Install dependencies
npm run dev            # Development with hot reload
npm run build          # Production build
npm run test           # Run test suite

# For users (npm package)
npm install -g kawa-fi-mcp  # Global installation
npx kawa-fi-mcp             # Direct execution

技术细节

有关完整的技术概述、挑战和体系结构详细信息，请参阅 提交.md.

🔗 文档链接

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支： git checkout -b feature/amazing-feature
  3. 提交更改： git commit -m 'Add amazing feature'
  4. 推送到分支： git push origin feature/amazing-feature
  5. 打开拉取请求

🐛 故障排除

常见问题

工具未出现：检查MCP配置和安装

npx kawa-fi-mcp --version  # Verify package is accessible

API超时：SaucerSwap有速率限制

# Retry requests or use smaller data ranges
# API tools may timeout but transaction tools work consistently

合同错误：验证网络配置

echo $HEDERA_NETWORK    # Should match your credentials
echo $EXECUTE_TX        # Should be "false" for prepare mode

缺少交易工具：确保已设置Hedera凭据

# For mainnet transaction tools:
echo $MAINNET_HEDERA_OPERATOR_ID    # Required for transaction preparation

获取帮助

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • 模型上下文协议 对于集成框架
  • Hedera 区块链基础设施
  • DeFi平台：SaucerSwap、Bonzo Finance、Stader、HeliSwap、Hashport

KawaFi -为AI助手统一Hedera DeFi🤖⚡

相关 MCP