收益优化协议服务器

Pendle Finance MCP Server 是一个基于AI技术的收益优化协议服务器,提供实时市场数据、AI收益预测、DeFi投资组合管理等功能,适用于DeFi市场的分析和决策支持。

  • by Nimish-Sharma-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Nimish-Sharma-dev/Pendle_mcp

使用说明

Pendle金融MCP服务器🚀

A. 模型上下文协议(MCP)服务器 为了 彭德金融 它为收益优化、市场分析和DeFi投资组合管理提供了人工智能驱动的工具。

✨ 特性

  • 🔍 实时市场数据 -从Pendle Finance市场获取实时收益
  • 🤖 人工智能产量预测 -使用加权评分算法的智能推荐
  • 📊 投资组合跟踪 -监控您的DeFi持有量和收益率
  • 💱 交易模拟 -执行前测试质押和交换
  • 📈 未来产量预测 -预测一段时间内的收益趋势
  • 🛡️ 风险分析 -根据流动性和波动性评估市场风险

🎯 什么是MCP?

这 模型上下文协议(MCP) 是将AI助手连接到外部工具和数据源的标准。该服务器将Pendle Finance功能作为MCP工具公开,可供Claude、ChatGPT或自定义LLM应用程序等AI代理使用。

重要:这是 不是REST API。它使用stdio传输,必须使用MCP兼容工具进行测试。

⚙️ 设置和安装

1.先决条件

  • Python 3.10+ 安装在您的系统上
  • Node.js 16+ (用于MCP检验员测试)
  • Git (克隆存储库)

2.克隆存储库

git clone https://github.com/maneesa029/Pendle_mcp
cd Pendle_mcp

3.创建虚拟环境

# Create virtual environment
python -m venv venv

# Activate it
# Windows:
venv\Scripts\activate

# macOS/Linux:
source venv/bin/activate

4.安装依赖项

pip install -r requirements.txt

5.配置环境

这 .env 文件已经配置了合理的默认值。如果需要,您可以对其进行自定义:

# Pendle API Configuration
PENDLE_API_URL=https://api-v2.pendle.finance/core/v1/1/markets
PENDLE_CHAIN_ID=1
API_TIMEOUT=10
LOG_LEVEL=INFO

# Optional: Blockchain Configuration (for real transactions)
RPC_URL=
PRIVATE_KEY=

⚠️ 安全警告:切勿使用您的主钱包私钥。为了测试,请离开 PRIVATE_KEY 空以仅模拟模式运行。

🚀 运行服务器

方法1:直接执行

python server.py

您应该看到:

============================================================
Starting Pendle Finance MCP Server
============================================================
User Address: 0x0000000000000000000000000000000000000000
Wallet Valid: False
Pendle API: https://api-v2.pendle.finance/core/v1/1/markets
============================================================
Server ready. Use MCP Inspector to test tools:
  npx @modelcontextprotocol/inspector python server.py
============================================================

按 Ctrl+C 停止。

方法2:MCP检查员(建议用于测试)

MCP检查器提供了一个web UI,用于交互式测试所有工具:

npx @modelcontextprotocol/inspector python server.py

这将:

  1. 启动MCP服务器
  2. 启动web界面(通常在 http://localhost:6274)
  3. 自动打开浏览器

在检查员中:

  • 转到 工具 标签
  • 查看所有7个可用工具
  • 单击任何工具,使用自定义输入进行测试
  • 实时查看响应

🔧 可用的MCP工具

1. get_yield(limit: int = 10)

从Pendle市场获得最高收益机会。

输入示例:

{"limit": 5}

退货: 包含APY、流动性、协议和到期数据的市场列表。


2. stake(data: Transaction)

在Pendle Finance中模拟质押代币。

输入示例:

{
  "user_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "token": "PENDLE",
  "amount": 100
}

退货: 模拟交易哈希和详细信息。


3. swap(data: Transaction)

模拟在Pendle上交换代币。

输入示例:

{
  "user_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "token": "sUSDe",
  "amount": 50
}

退货: 模拟掉期交易。


4. portfolio(address: str)

获取钱包地址的投资组合信息。

输入示例:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

退货: 持有量、总价值和估计收益率。


5. predict_best_token()

基于人工智能的推荐,以获得最佳收益机会。

不需要参数。

算法:

  • 隐含APY(固定收益率)的40%权重
  • 30%的流动性权重(安全性)
  • 基础APY的20%重量(基本产量)
  • 保质期为10%

退货: 最佳代币、预期收益、推理和前3个备选方案。


6. predict_future(token: str, days: int = 7)

预测N天内代币的未来收益率。

输入示例:

{
  "token": "sUSDe",
  "days": 7
}

退货: 具有置信区间的每日预测。


7. server_status()

获取服务器运行状况和配置。

不需要参数。

退货: 服务器状态、API连接、钱包信息和功能可用性。

✅ 验证和测试

运行验证脚本以检查您的设置:

python test_client.py

这将验证:

  • ✓ Python版本
  • ✓ 环境配置
  • ✓ 已安装依赖项
  • ✓ Pendle API连接
  • ✓ 服务器导入成功

🐛 故障排除

问题:“找不到模块'fastmcp'”

解决方案:

pip install -r requirements.txt

问题:“Pendle API连接失败”

解决方案:

  • 检查您的互联网连接
  • 验证中的API URL .env 是正确的
  • 尝试增加 API_TIMEOUT 在 .env

问题:“服务器已启动,但检查器中没有可见的工具”

解决方案:

  • 确保您使用了正确的命令:
    npx @modelcontextprotocol/inspector python server.py
    
  • 检查 server.py 没有语法错误
  • 在终端中查找错误消息

问题:测试股权/掉期时“地址格式无效”

解决方案:

  • 地址必须是42个字符(0x+40十六进制字符)
  • 有效地址示例: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

问题:“无法使用请求库进行测试”

解决方案:

  • 这不是一个REST API-它使用MCP协议(stdio)
  • 请改用MCP检查器: npx @modelcontextprotocol/inspector python server.py

📚 项目结构

Pendle_mcp/
├── server.py           # Main MCP server with all tools
├── ai_models.py        # AI prediction algorithms
├── test_client.py      # Validation and testing script
├── requirements.txt    # Python dependencies
├── .env               # Configuration (API URLs, timeouts)
├── .gitignore         # Git ignore rules
├── README.md          # This file
└── setup.sh           # Quick setup script (Unix/Mac)

🔐 安全最佳实践

  1. 永不承诺 .env 使用真正的私钥 到版本控制
  2. 切勿使用主钱包 -创建用于开发的测试钱包
  3. 使用环境变量 在生产中,不是 .env 文件
  4. 验证所有输入 -服务器包括Pydantic验证
  5. 监控API使用情况 -遵守Pendle API费率限制

🚧 路线图

  • []通过链上数据进行真实投资组合跟踪
  • []历史收益率数据和图表
  • []多链支持(Arbitrum,乐观主义)
  • []用于预测的高级ML模型
  • []真正的区块链交易执行
  • []WebSocket支持实时更新

🤝 贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

📄 许可证

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

🙏 致谢

📞 支持


内置于❤️ 对于DeFi社区