Servidor MCP de Agentipy para Claude Desktop

Versión de Python Licencia: MIT

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas en cadena para Claude AI, permitiéndole interactuar con la blockchain de Solana mediante una interfaz estandarizada. Esta implementación utiliza Agentipy y permite a los agentes de IA realizar operaciones en la blockchain sin problemas.

Descripción general

Este servidor MCP amplía las capacidades de Claude al proporcionar herramientas para:

Interactuar con la cadena de bloques de Solana
Ejecutar transacciones
Consultar información de la cuenta
Administrar billeteras Solana
Obtenga predicciones de precios
Intercambio y participación de tokens
Implementar nuevos tokens
Obtenga información del token de CoinGecko
Ejecutar transacciones de puente entre cadenas utilizando deBridge
Obtenga datos de precios en tiempo real de Pyth Network
Acceda a información completa sobre tokens de CoinGecko
Monitorear tokens y pools de tendencia
Realice un seguimiento de los principales ganadores y los movimientos del mercado
Obtenga datos y análisis detallados del precio del token

El servidor implementa la especificación del Protocolo de Contexto de Modelo para estandarizar las interacciones de blockchain para los agentes de IA.

Related MCP server: Solana Agent Kit MCP Server

Prerrequisitos

Python 3.8 o superior
Claude Desktop instalado
Monedero Solana con clave privada
URL de Solana RPC (mainnet, testnet o devnet)
Clave API de OpenAI (opcional)
Clave API de Allora (opcional)
Clave API de CoinGecko Pro (opcional)

Instalación

Opción 1: Instalación rápida (recomendada)

# 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

Opción 2: Configuración manual

Crear un entorno virtual:

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

Instalar los paquetes necesarios:

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

Configuración

Configuración del entorno

Crea un archivo .env con tus credenciales:

# 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

Integración con Claude Desktop

Para agregar este servidor MCP a Claude Desktop, siga estos pasos:

Localice el archivo de configuración de Claude Desktop
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude\claude_desktop_config.json

Agregar la configuración Cree o edite el archivo de configuración y agregue el siguiente JSON:

Nota : Para el campo command , utilice run_mcp.sh en sistemas Unix/Mac o run_mcp.bat en sistemas Windows. Asegúrese de usar la ruta absoluta correcta al archivo de script en su sistema.

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

Reiniciar Claude Desktop Después de realizar estos cambios, reinicie Claude Desktop para que la configuración surta efecto.

Estructura del proyecto

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

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas de blockchain:

Acciones de Native Solana

GET_BALANCE - Consultar el saldo de la billetera
TRANSFER - Transferir tokens entre billeteras
DEPLOY_TOKEN - Implementar nuevos tokens en Solana

Acciones de Allora

GET_PRICE_PREDICTION - Obtener predicciones de precios
GET_ALL_TOPICS - Obtener los temas disponibles

Acciones de Júpiter

STAKE_WITH_JUP - Apuesta tokens usando Jupiter
TRADE_WITH_JUP - Intercambia tokens usando Jupiter

Acciones de DeBridge

CREATE_DEBRIDGE_TRANSACTION : crea una transacción puente entre cadenas utilizando la API de deBridge Liquidity Network
EXECUTE_DEBRIDGE_TRANSACTION : ejecuta una transacción de puente entre cadenas mediante la API de deBridge Liquidity Network
CHECK_TRANSACTION_STATUS : verifica el estado de una transacción de puente entre cadenas mediante la API de deBridge Liquidity Network

Acciones de Pyth

PYTH_GET_PRICE - Obtener el precio de una moneda de Pyth

Acciones de CoinGecko

COINGECKO_GET_TOKEN_INFO - Obtener información del token de CoinGecko
COINGECKO_GET_COIN_PRICE_VS - Obtenga el precio de una moneda en una moneda específica de Coingecko
COINGECKO_GET_TOP_GAINERS - Consigue los mejores ganadores de Coingecko
COINGECTO_GET_TRENDING_POOLS - Obtén los pools de tendencias de Coingecko
COINGECKO_GET_TRENDING_TOKENS - Obtén los tokens de tendencia de Coingecko
COINGECKO_GET_TOKEN_PRICE_DATA : Obtener datos del precio del token de Coingecko
COINGECKO_GET_LATEST_POOLS - Obtén los pools más recientes de Coingecko

Consideraciones de seguridad

Mantenga su clave privada segura y nunca la comparta
Utilice variables de entorno para información confidencial
Considere usar una billetera dedicada para las operaciones del agente de IA
Supervisar y auditar periódicamente las actividades de los agentes de IA
Operaciones de prueba en devnet/testnet antes de mainnet

Solución de problemas

Si encuentra problemas:

Verifique que su clave privada de Solana sea correcta
Comprueba que tu URL de RPC sea accesible
Asegúrese de que todas las dependencias estén instaladas correctamente
Verifique que su archivo .env contenga las credenciales correctas
Consulte los registros de Claude Desktop para ver si hay mensajes de error

Dependencias

Las dependencias clave incluyen:

agentipy - Interacción en la blockchain de Solana
python-dotenv - Gestión del entorno
mcp - Protocolo de contexto del modelo

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Agentipy MCP Server for Claude Desktop