AI导哈

DeFi数据查询服务器

DeBank MCP Server是一个连接DeBank API与AI助手的MCP服务器，支持通过自然语言查询DeFi数据，包括钱包余额、代币信息、NFT收藏、DeFi头寸等。

  • by caiovicentino
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 caiovicentino/debank-mcp-server

使用说明

DeBank MCP服务器

MCP（模型上下文协议）服务器，用于与 DeBank API 集成，允许通过 AI 查询 DeFi 数据。

📋 索夫雷

哦 DeBank MCP服务器 它是一个MCP服务器，将DeBank强大的API与Claude Desktop等AI助手连接起来。有了它，您可以通过对话自然查询DeFi数据，包括：

  • 💰 余额和投资组合
  • 🪙 代币和价格信息
  • 🎨 NFT 集合
  • 🏦 DeFi 协议中的位置
  • 📊 交易历史
  • 🔒 批准安全分析
  • ⛽ 实时天然气价格
  • 还有更多！

✨ 功能

核心工具（4）

  • 链条列出所有支持的区块链（93+链）
  • 协议使用 TVL 的 DeFi 协议信息
  • 代币价格、元数据和代币持有者
  • 平衡跨链投资组合总余额

投资组合工具（5）

  • 用户令牌：持有菲律宾代币
  • 用户NFT带元数据的 NFT 集合
  • 用户协议DeFi 位置（简单/复杂）
  • 用户历史记录交易历史
  • 用户批准审批安全分析

高级工具（6）

  • 净曲线24小时价值趋势
  • 游泳池信息：流动性池分析
  • 交易模拟: 发送前模拟交易
  • 天然气价格天然气价格按级别
  • 账户单位API 使用监控
  • 用户社交：占位符指向Futuro OAuth

总计15个功能齐全的工具！

🚀 安装

先决条件

  • Python 3.10或更高级
  • DeBank Cloud 帐户（获取 API 密钥）
  • Claude Desktop（或其他 MCP 客户端）

步骤1：从DeBank获取API密钥

  1. 访问 德银云
  2. 创建一个帐户或登录
  3. 导航到API部分
  4. 复制您的 Access Key

步骤 2: 安装服务器

# Clone o repositório
git clone https://github.com/caiovicentino/debank-mcp-server.git
cd debank-mcp-server

# Instale as dependências
pip install -e .

Passo 3：配置程序API密钥

创建文件 .env 工程根 ：

DEBANK_ACCESS_KEY=sua_api_key_aqui

⚠️ 重要永远不要共享或提交您的API密钥！

第四步：测试服务器

# Teste se está funcionando
python -c "from mcp_server_debank.server import mcp; print('✅ Servidor OK!')"

🔧 Claude 桌面配置

macOS

  1. 编辑配置文件 ：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加 DeBank 服务器 ：
{
  "mcpServers": {
    "debank": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_debank.server"
      ],
      "cwd": "/caminho/para/debank-mcp-server",
      "env": {
        "DEBANK_ACCESS_KEY": "sua_api_key_aqui",
        "PYTHONPATH": "/caminho/para/debank-mcp-server/src"
      }
    }
  }
}
  1. 替换 /caminho/para/debank-mcp-server 在真正的道路上
  2. 替换 sua_api_key_aqui 您的 DeBank API 密钥
  3. 重新设计克劳德桌面

视窗

  1. 编辑配置文件 ：
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. 使用上述相同的设置来调整 Windows 的路径：
{
  "mcpServers": {
    "debank": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_debank.server"
      ],
      "cwd": "C:\\caminho\\para\\debank-mcp-server",
      "env": {
        "DEBANK_ACCESS_KEY": "sua_api_key_aqui",
        "PYTHONPATH": "C:\\caminho\\para\\debank-mcp-server\\src"
      }
    }
  }
}

Linux

  1. 编辑配置文件 ：
nano ~/.config/Claude/claude_desktop_config.json
  1. 使用与 macOS 相同的设置

💡 使用范例

设置后，您可以在 Claude 中自然提问：

查询余额

Qual é o saldo total da carteira vitalik.eth?

令牌信息

Me mostre informações sobre o token USDT na Ethereum

投资组合分析

Quais protocolos DeFi a carteira 0x... está usando?

安全

Liste os approvals de token da carteira 0x... na Ethereum

天然气价格

Qual o preço do gas na Ethereum agora?

NFT

Quantos NFTs a carteira 0x... possui?

交易模拟

Simule esta transação antes de enviar: {dados da transação}

池分析

Me dê informações sobre o pool 0x... na Ethereum

📊 项目结构

debank-mcp-server/
├── src/
│   └── mcp_server_debank/
│       ├── __init__.py
│       ├── server.py              # Servidor MCP principal
│       ├── client.py              # Cliente HTTP DeBank
│       ├── validators.py          # Validação de inputs
│       ├── models.py              # Modelos Pydantic
│       ├── portfolio_tools.py     # Tools de portfolio
│       └── advanced_tools.py      # Tools avançados
├── tests/                         # Testes (opcional)
├── pyproject.toml                 # Configuração do projeto
├── .env.example                   # Template de configuração
├── .gitignore                     # Arquivos ignorados
└── README.md                      # Esta documentação

🔐 安全

  • ✅ 从不 分享您的 DeBank API 密钥
  • ✅ 使用档案 .env 存储凭据
  • ✅ 添加 .env 奥 .gitignore
  • ✅ 立即撤销已损坏的密钥 德银云
  • ✅ 定期使用该工具监控 API 使用情况 debank_get_account_units
  • ⚠️ 不要在提交、日志或截图中暴露您的 API 密钥
  • ⚠️ 在发送实际交易之前使用交易模拟工具

🐛 故障排除

错误：“找不到DEBANK_ACCESS_KEY”

解决方案请确保文件 .env 存在并包含您的API密钥，或者环境变量已正确配置 claude_desktop_config.json.

错误：“未找到MCP工具”

解决方案:

  1. 完全重新启动或Claude Desktop（CMD+Q No Macos并重新打开）
  2. 检查路径 cwd Config是正确的
  3. 检查是否 PYTHONPATH 指向目录 src

响应非常大

解决方案使用组合工具中的分页参数：

  • limit减少结果数量（默认值：20，最大值：500）
  • offset： 通过结果浏览

错误401：未经授权

解决方案:

  1. 检查您的 API 密钥是否正确
  2. 请确认密钥是否激活于 德银云
  3. 尝试生成新的API密钥

错误429：费率限制

解决方案:

  • 或服务器实现指数自动COM回退重试
  • 请求之间等待几秒钟
  • 考虑在 DeBank Cloud 上升级计划以获得更高的限额

错误：“ModuleNotFoundation错误：没有名为'mcp_server_debank'的模块”

解决方案:

  1. 请确保您已执行 pip install -e . 在 根目录
  2. 检查是否 PYTHONPATH config 指向目录 src
  3. 尝试重新安装 ： pip uninstall mcp-server-debank && pip install -e .

Claude Desktop 没有载入伺服器

解决方案:

  1. Abra o菜单开发人员没有克劳德桌面（查看>开发人员）
  2. 在 MCP 标签中检查服务器日志
  3. 确认 JSON 配置文件有效（使用 JSON 验证器）
  4. 手动测试服务器 ： python -m mcp_server_debank.server

📈 API有限公司

  • 速率限制： 不同计划 （在 Pro 计划中最高可达 100 req/s）
  • 分页每页最多 500 个项目（可配置）
  • 链条：支持93多个区块链
  • 单位每个呼叫消耗其配额的单位（监控 debank_get_account_units)

🤝 贡献

欢迎捐款！欢迎：

  1. 分叉工程
  2. 为您的功能创建一个分支 （git checkout -b feature/MinhaFeature)
  3. 提交您的更改（git commit -m 'Add: MinhaFeature')
  4. 推动一个分支(git push origin feature/MinhaFeature)
  5. 打开 Pull Request

贡献的想法

  • 🧪 添加单元和集成测试
  • 📚 改进文档和示例
  • 🐛 报告和修正错误
  • ✨ 部署基于 DeBank 端点的新工具
  • 🌐 添加其他语言支持
  • 🔧 改进错误处理和验证

📝 更新日志

v1.0.0（2025-01-11）

  • ✅ 15个全功能MCP工具
  • ✅ 支持93+区块链
  • ✅ 在所有相关工具中实现的分页
  • ✅ 使用 Pydantic 进行强大的类型安全和验证
  • ✅ 错误处理完成自动COM重试
  • ✅ 生产就绪记录
  • ✅ 完整的文档中文

📄 许可证

这个项目是MIT许可的。查看文件 许可证 了解更多详情。

👨‍💻 作者

开发者：Caio Vicentino

对于社区：

  • 🌾 屈服黑客 - 最大限度地提高DeFi的产量
  • 💰 Reins脚本 加密金融教育
  • 🏗️ 文化建设者 用AI构建未来

🔗 链接乌斯

⭐ 支持项目

如果这个项目对你有帮助，请考虑：

  • ⭐ 在GitHub上评分一颗星
  • 🐛 报告错误并建议改进
  • 🤝 贡献代码
  • 📢 与社区分享
  • 💬 提供您的体验反馈
  • 🎓 创建教程和教育内容

由❤️ 巴西 Web3 社区

相关 MCP