Agentipy Mcp Server

面向 Claude Desktop 的 Agentipy MCP 服务

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

概述

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

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

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

先决条件

• Python 3.8 或更高版本
• 已安装 Claude Desktop
• 拥有私钥的 Solana 钱包
• Solana RPC URL（mainnet、testnet 或 devnet）
• OpenAI API Key（可选）
• Allora API Key（可选）
• CoinGecko Pro API Key（可选）

安装

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

# Clone the repository
git clone https://github.com/niceberginc/agentipy-mcp
cd agentipy-mcp

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

# Install dependencies
pip install -r requirements.txt

选项 2：手动设置

1. 创建虚拟环境：

python -m venv .venv
source .venv/bin/activate  # On Windows, use `.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 Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here

# Optional API Keys
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 字段，Unix/Mac 系统请使用 run_mcp.sh，Windows 系统请使用 run_mcp.bat。请确保使用系统中脚本文件的正确绝对路径。

   {
     "mcpServers": {
       "agentipy": {
         "command": "/path/to/your/run_mcp.sh",  # Replace with .bat for Windows
         "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          # Main entry point
├── run_mcp.sh         # Run script for Unix/Mac
├── run_mcp.bat        # Run script for Windows
├── requirements.txt   # Dependencies
└── .env              # Environment variables

可用工具

此 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 Agent 操作使用专用钱包
• 定期监控并审计 AI Agent 活动
• 在主网操作之前，先在 devnet/testnet 上进行测试

故障排除

如果遇到问题：

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 License 授权。