MCP AI Agent Server

Servidor MCP AI Agent

Un servidor MCP que conecta Cline con un sistema de agentes de IA, permitiendo una interacción fluida con agentes de IA a través del Protocolo de Contexto de Modelo.

Características

• 🚀 Enviar Mensajes: Envía mensajes a agentes de IA dentro de una sesión.
• 💡 Gestión de Sesiones: Limpia sesiones e inicia otras nuevas.
• 🔧 Gestión de Asistentes: Obtén una lista de asistentes disponibles y cambia el asistente para una sesión.

Inicio Rápido

Instalar vía npm (Recomendado)

npm install -g @avi/mcp-ai-agent-server

Instalar vía npx (Sin necesidad de instalación)

npx @avi/mcp-ai-agent-server

Configuración

Para Cline

Añade a tu archivo de configuración MCP de Cline:

Ubicación:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Configuración:

{
  "mcpServers": {
    "ai-agent-mcp": {
      "command": "npx",
      "args": ["@avi/mcp-ai-agent-server"],
      "env": {
        "AI_AGENT_API_KEY": "your-api-key-here",
        "AI_AGENT_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Herramientas Disponibles

send_message

Envía un mensaje en una sesión con archivos adjuntos opcionales.

Parámetros:

• messageContent (obligatorio): El contenido del mensaje a enviar.
• attachments (opcional): Un array de archivos adjuntos.

Ejemplo:

"Can you use send_message to say 'hello'?"

get_session

Obtiene o crea una sesión.

Parámetros:

• Ninguno

Ejemplo:

"Get the current session."

clear_session

Limpia la sesión actual e inicia una nueva.

Parámetros:

• Ninguno

Ejemplo:

"Please clear the session."

get_assistants

Obtiene una lista de asistentes disponibles.

Parámetros:

• Ninguno

Ejemplo:

"List the available assistants."

change_assistant

Cambia el asistente para una sesión.

Parámetros:

• sessionId (obligatorio): El ID de la sesión a actualizar.
• newAssistantId (obligatorio): El ID del nuevo asistente.

Ejemplo:

"Change the assistant for the current session to 'assistant-2'."

Variables de Entorno

Variable	Descripción	Obligatoria	Valor por Defecto
AI_AGENT_API_KEY	Clave API para autenticación	Sí	-
AI_AGENT_BASE_URL	Endpoint API personalizado para el sistema de agentes de IA	No	http://localhost:3000

Solución de Problemas

Tiempo de Espera Agotado en la Operación

Si encuentras un error de "Operation timed out", significa que la solicitud al servicio de agentes de IA está tardando más que el tiempo de espera interno predeterminado del servidor. Puedes resolverlo aumentando el valor de timeout en tu configuración MCP de Cline:

{
  "mcpServers": {
    "ai-agent-mcp": {
      "command": "npx",
      "args": ["@avi/mcp-ai-agent-server"],
      "timeout": 300000, // 5 minutes
      "env": {
        "AI_AGENT_API_KEY": "your-api-key-here",
        "AI_AGENT_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Desarrollo

Compilar desde el código fuente

git clone https://github.com/avi/mcp-ai-agent-server.git
cd mcp-ai-agent-server
npm install
npm run build

Pruebas locales

# Using MCP Inspector
npx @modelcontextprotocol/inspector ./build/index.js

# Manual testing
AI_AGENT_API_KEY=test-key node ./build/index.js

Licencia

MIT - Consulta LICENSE para más detalles.

Agradecimientos

Construido con el Model Context Protocol SDK