Servidor MCP de Agentipy para Claude Desktop

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

1. Crear un entorno virtual:

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

2. 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:

1. 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

2. 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"]
       }
     }
   }

3. 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:

1. Verifique que su clave privada de Solana sea correcta

2. Comprueba que tu URL de RPC sea accesible

3. Asegúrese de que todas las dependencias estén instaladas correctamente

4. Verifique que su archivo .env contenga las credenciales correctas

5. 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.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.