使用说明

Claude桌面版代理MCP服务器

一个模型上下文协议（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密钥（可选）
然后API密钥（可选）
CoinGecko Pro API密钥（可选）

安装

选项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：手动设置

创建虚拟环境：

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

安装所需的软件包：

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，请执行以下步骤：

找到Claude桌面配置文件
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- 窗户： %APPDATA%\Claude\claude_desktop_config.json
- Linux： ~/.config/Claude\claude_desktop_config.json

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

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

{
  "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"]
    }
  }
}

重新启动克劳德桌面 进行这些更改后，重新启动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服务器提供以下区块链工具：

索拉纳土著行动

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

然后动作

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

木星行动

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

德布里奇行动

CREATE_DEBRIDGE_TRANSACTION -使用deBridge流动性网络API创建跨链桥接交易
EXECUTE_DEBRIDGE_TRANSACTION -使用deBridge流动性网络API执行跨链桥接交易
CHECK_TRANSACTION_STATUS -使用deBridge流动性网络API检查跨链桥接交易的状态

Python动作

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上进行测试操作

故障排除

如果您遇到问题：

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

依赖项

关键依赖关系包括：

代理 -Solana区块链交互
python dotenv -环境管理
主控程序 -模型上下文协议

贡献

欢迎投稿！请随时提交拉取请求。

分叉存储库
创建功能分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add some amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

许可证

该项目根据MIT许可证获得许可。