使用说明
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
这将:
- 启动MCP服务器
- 启动web界面(通常在
http://localhost:6274) - 自动打开浏览器
在检查员中:
- 转到 工具 标签
- 查看所有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)
🔐 安全最佳实践
- 永不承诺
.env使用真正的私钥 到版本控制 - 切勿使用主钱包 -创建用于开发的测试钱包
- 使用环境变量 在生产中,不是
.env文件 - 验证所有输入 -服务器包括Pydantic验证
- 监控API使用情况 -遵守Pendle API费率限制
🚧 路线图
- []通过链上数据进行真实投资组合跟踪
- []历史收益率数据和图表
- []多链支持(Arbitrum,乐观主义)
- []用于预测的高级ML模型
- []真正的区块链交易执行
- []WebSocket支持实时更新
🤝 贡献
欢迎投稿!拜托:
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用,添加测试
- 提交拉取请求
📄 许可证
MIT许可证-有关详细信息,请参阅许可证文件
🙏 致谢
📞 支持
- 问题: GitHub问题
- Pendle文档: 财务文件
- MCP文件: 模型上下文协议.io
内置于❤️ 对于DeFi社区