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：

   注意: 对于 command 字段，使用 run_mcp.sh 适用于 Unix/Mac 系统，使用 run_mcp.bat 适用于 Windows 系统。确保使用系统上的正确绝对路径。

   {
     "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 Desktop 做出这些更改后，重启 Claude Desktop 以使配置生效。

项目结构

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 流动性网络 API 创建跨链桥接交易
• EXECUTE_DEBRIDGE_TRANSACTION - 使用 deBridge 流动性网络 API 执行跨链桥接交易
• CHECK_TRANSACTION_STATUS - 使用 deBridge 流动性网络 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 Desktop 日志以获取错误消息

依赖项

关键依赖项包括：

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

贡献

欢迎贡献！请自由提交拉取请求。

1. 叉仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交您的更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 开启拉取请求

许可证

本项目采用 MIT 许可证。