Agentipy MCP 服务器，适用于 Claude Desktop

一个模型上下文协议 (MCP) 服务器，为 Claude AI 提供链上工具，使其能够通过标准化接口与 Solana 区块链交互。此实现使用 Agentipy，使 AI 代理能够无缝执行区块链操作。

概述

此 MCP 服务器通过提供以下工具扩展了 Claude 的功能：

• 与 Solana 区块链交互
• 执行交易
• 查询账户信息
• 管理 Solana 钱包
• 获取价格预测
• 交易和质押代币
• 部署新代币
• 从 CoinGecko 获取代币信息
• 使用 deBridge 执行跨链桥交易
• 从 Pyth Network 获取实时价格数据
• 从 CoinGecko 访问全面的代币信息
• 监控热门代币和资金池
• 跟踪涨幅最高的代币和市场动向
• 获取详细的代币价格数据和分析

该服务器实现了模型上下文协议规范，以标准化 AI 代理的区块链交互。

前提条件

• Python 3.8 或更高版本
• 已安装 Claude Desktop
• 带有私钥的 Solana 钱包
• Solana RPC URL（主网、测试网或开发网）
• OpenAI API 密钥（可选）
• Allora API 密钥（可选）
• CoinGecko Pro API 密钥（可选）

安装

选项 1：快速安装（推荐）

# 克隆存储库
git clone https://github.com/niceberginc/agentipy-mcp
cd agentipy-mcp

# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`

# 安装依赖项
pip install -r requirements.txt

选项 2：手动设置

1. 创建一个虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`

2. 安装所需的软件包：

pip install agentipy>=2.0.8 cryptography>=3.4.7 python-dotenv>=0.17.1 web3>=7.8.0 allora_sdk>=0.2.0 mcp>=1.4.0

配置

环境设置

创建一个包含您的凭据的 .env 文件：

# Solana 配置
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here

# 可选 API 密钥
OPENAI_API_KEY=your_openai_api_key
ALLORA_API_KEY=your_allora_api_key
COINGECKO_PRO_API_KEY=your_coingecko_api_key

与 Claude Desktop 集成

要将此 MCP 服务器添加到 Claude Desktop，请按照以下步骤操作：

1. 找到 Claude Desktop 配置文件

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude\claude_desktop_config.json

2. 添加配置 创建或编辑配置文件并添加以下 JSON：

   {
     "mcpServers": {
       "agentipy": {
         "command": "/path/to/your/run_mcp.sh",
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key",
           "ALLORA_API_KEY": "your_allora_api_key",
           "COINGECKO_PRO_API_KEY": "your_coingecko_api_key"
         },
         "disabled": false,
         "autoApprove": ["GET_BALANCE", "GET_PRICE_PREDICTION"]
       }
     }
   }
   

3. 重启 Claude Desktop 进行这些更改后，重启 Claude Desktop 以使配置生效。

项目结构

agentipy-mcp/
├── server.py          # 主要入口点
├── run_mcp.sh         # 运行脚本
├── requirements.txt   # 依赖项
└── .env              # 环境变量

可用工具

MCP 服务器提供以下区块链工具：

原生 Solana 操作

• GET_BALANCE - 检查钱包余额
• TRANSFER - 在钱包之间转移代币
• DEPLOY_TOKEN - 在 Solana 上部署新代币

Allora 操作

• GET_PRICE_PREDICTION - 获取价格预测
• GET_ALL_TOPICS - 获取可用主题

Jupiter 操作

• STAKE_WITH_JUP - 使用 Jupiter 质押代币
• TRADE_WITH_JUP - 使用 Jupiter 交易代币

DeBridge 操作

• CREATE_DEBRIDGE_TRANSACTION - 使用 deBridge Liquidity Network API 创建跨链桥交易
• EXECUTE_DEBRIDGE_TRANSACTION - 使用 deBridge Liquidity Network API 执行跨链桥交易
• CHECK_TRANSACTION_STATUS - 使用 deBridge Liquidity Network API 检查跨链桥交易的状态

Pyth 操作

• PYTH_GET_PRICE - 从 Pyth 获取代币价格

CoinGecko 操作

• COINGECKO_GET_TOKEN_INFO - 从 CoinGecko 获取代币信息
• COINGECKO_GET_COIN_PRICE_VS - 从 Coingecko 获取特定货币的代币价格
• COINGECKO_GET_TOP_GAINERS - 从 Coingecko 获取涨幅最高的代币
• COINGECTO_GET_TRENDING_POOLS - 从 Coingecko 获取热门资金池
• COINGECKO_GET_TRENDING_TOKENS - 从 Coingecko 获取热门代币
• COINGECKO_GET_TOKEN_PRICE_DATA - 从 Coingecko 获取代币价格数据
• COINGECKO_GET_LATEST_POOLS - 从 Coingecko 获取最新资金池

安全注意事项

• 确保您的私钥安全，切勿分享
• 使用环境变量存储敏感信息
• 考虑使用专用钱包进行 AI 代理操作
• 定期监控和审计 AI 代理活动
• 在主网上进行操作之前，先在开发网/测试网上进行测试

故障排除

如果您遇到问题：

1. 验证您的 Solana 私钥是否正确
2. 检查您的 RPC URL 是否可访问
3. 确保所有依赖项都已正确安装
4. 验证您的 .env 文件是否包含正确的凭据
5. 检查 Claude Desktop 日志以查找错误消息

依赖项

主要依赖项包括：

• agentipy - Solana 区块链交互
• python-dotenv - 环境管理
• mcp - 模型上下文协议

贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

此项目已获得 MIT 许可证的许可。