使用说明

项目简介

Agentipy MCP服务器是一个基于Model Context Protocol (MCP) 实现的服务器，专门为Claude等大型语言模型 (LLM) 设计，旨在扩展LLM与Solana区块链的交互能力。通过此服务器，LLM可以安全、便捷地访问Solana链上数据，并执行交易等操作，从而实现更丰富的链上应用场景。

主要功能点

Solana区块链交互: 提供丰富的工具，使LLM能够与Solana区块链进行深度交互。
链上数据访问: 支持查询Solana账户信息、代币信息、实时价格数据等链上数据。
链上交易执行: 允许LLM调用工具执行Solana链上的交易，如代币转账、Staking、交易、部署新代币等。
跨链桥接: 集成deBridge，支持LLM发起和执行跨链桥接交易。
价格预测: 集成Allora，为LLM提供价格预测能力。
多种数据源: 整合CoinGecko、Pyth Network等数据源，提供全面的链上信息。

安装步骤

克隆仓库:

git clone https://github.com/niceberginc/agentipy-mcp
cd agentipy-mcp

创建并激活虚拟环境 (推荐):

python -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate  # Windows

安装依赖:

pip install -r requirements.txt

服务器配置

为了让MCP客户端（如Claude Desktop）连接到Agentipy MCP服务器，您需要在客户端的配置文件中添加服务器配置信息。以下是针对Claude Desktop的配置示例，请根据您的实际情况进行调整。

Claude Desktop 配置 (claude_desktop_config.json):

{
  "mcpServers": {
    "agentipy": {
      "command": "/path/to/your/agentipy-mcp/run_mcp.sh",  // 修改为 run_mcp.bat 如果您使用 Windows，并替换为 run_mcp 脚本的绝对路径
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",  // 您的 Solana RPC URL，例如：https://api.mainnet-beta.solana.com
        "SOLANA_PRIVATE_KEY": "your_private_key_here", // 您的 Solana 钱包私钥，请务必安全保管
        "OPENAI_API_KEY": "your_openai_api_key",    // 可选: OpenAI API Key，如果需要使用相关功能
        "ALLORA_API_KEY": "your_allora_api_key",      // 可选: Allora API Key，如果需要使用 Allora 功能
        "COINGECKO_PRO_API_KEY": "your_coingecko_api_key" // 可选: CoinGecko Pro API Key，如果需要使用 CoinGecko Pro 功能
      },
      "disabled": false,
      "autoApprove": ["GET_BALANCE", "GET_PRICE_PREDICTION"] // 可选: 自动批准的工具，例如这里设置了 GET_BALANCE 和 GET_PRICE_PREDICTION 工具无需用户手动批准即可执行
    }
  }
}

配置说明:

'server name': 'agentipy' - 服务器名称，在客户端中用于标识和调用。
'command': '/path/to/your/agentipy-mcp/run_mcp.sh' (或 'run_mcp.bat' for Windows) - 必须修改为实际的 'run_mcp.sh' 或 'run_mcp.bat' 脚本的绝对路径。 此脚本用于启动 Agentipy MCP 服务器。
'env': 环境变量配置，服务器启动时会读取这些环境变量。
- 'RPC_URL': 必须配置，Solana RPC 节点的URL，用于与Solana区块链进行通信。
- 'SOLANA_PRIVATE_KEY': 必须配置，Solana 钱包的私钥，用于进行链上交易。请务必谨慎保管私钥，并建议使用专门用于Agentipy MCP服务器的钱包。
- 'OPENAI_API_KEY', 'ALLORA_API_KEY', 'COINGECKO_PRO_API_KEY': 可选配置，根据您需要使用的工具功能进行配置。如果不需要使用相关功能，可以不配置。
'disabled': 'false' - 设置为 'false' 表示启用该服务器。
'autoApprove': 可选配置，列出无需用户手动批准即可自动执行的工具名称。

启动服务器:

在配置好 Claude Desktop 后，您需要启动 Agentipy MCP 服务器。

配置 '.env' 文件: 在 'agentipy-mcp' 目录下创建 '.env' 文件，并将上述 'env' 中的环境变量写入 '.env' 文件中，例如：

SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key
ALLORA_API_KEY=your_allora_api_key
COINGECKO_PRO_API_KEY=your_coingecko_api_key

运行启动脚本: 根据您的操作系统，运行 'run_mcp.sh' (Linux/macOS) 或 'run_mcp.bat' (Windows) 脚本来启动服务器。

./run_mcp.sh   # Linux/macOS
run_mcp.bat    # Windows

基本使用方法

确保 Agentipy MCP 服务器已成功启动并运行。
启动 Claude Desktop 客户端。
在 Claude Desktop 中，您应该能够通过自然语言指令调用 Agentipy MCP 服务器提供的工具，例如：
- "查询我的Solana钱包余额" (对应 'GET_BALANCE' 工具)
- "预测Solana价格" (对应 'GET_PRICE_PREDICTION' 工具)
- "将1个SOL转账到某个Solana地址" (对应 'TRANSFER' 工具)
具体的工具调用方式和指令取决于 Claude Desktop 客户端的实现和 Agentipy MCP 服务器提供的工具描述。请参考 Claude Desktop 的相关文档和 Agentipy MCP 服务器提供的工具列表。

注意: 请务必仔细阅读仓库的 README.md 文件，了解更详细的信息和安全注意事项。

关键词