Agentipy MCP 服务器用于 Claude 桌面版

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

概述

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

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

该服务器实现了 Model Context Protocol 规范，以标准化 AI 代理的区块链交互。

前提条件

• Python 3.8 或更高版本
• 已安装 Claude 桌面版
• 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 桌面版集成

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

1. 定位 Claude 桌面版配置文件

   • 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：

   注意：对于 command 字段，在 Unix/Mac 系统上使用 run_mcp.sh，在 Windows 系统上使用 run_mcp.bat。确保使用系统上的脚本文件的正确绝对路径。

   json 复制代码

   {
     "mcpServers": {
       "agentipy": {
         "command": "/path/to/your/run_mcp.sh",  // 对于 Windows 使用 .bat
         "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 桌面版
   进行这些更改后，重启 Claude 桌面版以使配置生效。

项目结构

agentipy-mcp/
├── server.py          # 主入口点
├── run_mcp.sh         # Unix/Mac 运行脚本
├── run_mcp.bat        # Windows 运行脚本
├── 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 代理活动
• 在主网上操作之前先在 devnet/testnet 上测试

故障排除

如果遇到问题：

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

依赖项

关键依赖项包括：

• agentipy - Solana 区块链交互
• python-dotenv - 环境管理
• mcp - Model Context Protocol

贡献

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

1. 分叉仓库
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 许可证。