Arcanna MCP Server

Interactúa con los casos de uso de IA de Arcanna a través del Protocolo de Contexto del Modelo (MCP).

Documentación

Arcanna MCP Server

El servidor Arcanna MCP permite al usuario interactuar con los casos de uso de IA de Arcanna a través del Model Context Protocol (MCP).

Uso con Claude Desktop u otros clientes MCP

Configuración

Agrega la siguiente entrada a la sección mcpServers en tu archivo de configuración del cliente MCP (claude_desktop_config.json para Claude Desktop).

Usa la imagen de Docker (https://hub.docker.com/r/arcanna/arcanna-mcp-server) o el paquete PyPi (https://pypi.org/project/arcanna-mcp-server/)

Construyendo una imagen local desde este repositorio

Requisitos previos

Configuración

  1. Cambia al directorio donde se encuentra el Dockerfile.
  2. Ejecuta docker build -t arcanna/arcanna-mcp-server . --progress=plain --no-cache
  3. Agrega la configuración a continuación a tu configuración de cliente de claude desktop/mcp.
{
  "mcpServers": {
    "arcanna-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ARCANNA_MANAGEMENT_API_KEY",
        "-e",
        "ARCANNA_HOST",
        "arcanna/arcanna-mcp-server"
      ],
      "env": {
        "ARCANNA_MANAGEMENT_API_KEY": "<ARCANNA_MANAGEMENT_API_KEY>",
        "ARCANNA_HOST": "<YOUR_ARCANNA_HOST_HERE>"
      }
    }
  }
}

Características

  • Gestión de recursos: Crear, actualizar y recuperar recursos de Arcanna (trabajos, integraciones)
  • Codificación en Python: Generación de código, ejecución y guardado del bloque de código como una integración de Arcanna
  • Consulta de eventos de Arcanna: Consultar eventos procesados por Arcanna
  • Gestión de trabajos: Crear, recuperar, iniciar, detener y entrenar trabajos
  • Sistema de retroalimentación: Proporcionar retroalimentación sobre decisiones para mejorar la precisión del modelo
  • Monitoreo de salud: Verificar el estado del servidor y de la clave de API

Herramientas

Consulta de eventos de Arcanna

  • query_arcanna_events

    • Se utiliza para obtener eventos procesados por Arcanna, se pueden proporcionar múltiples filtros
  • get_filter_fields

    • Se utiliza como herramienta auxiliar (recupera los campos posibles de Arcanna para aplicar filtros)

Gestión de recursos

  • upsert_resources

    • Crear/actualizar recursos de Arcanna
  • get_resources

    • Recuperar recursos de Arcanna (trabajos/integraciones)
  • delete_resources

    • Eliminar recursos de Arcanna
  • integration_parameters_schema

    • Se utiliza en este contexto como herramienta auxiliar

Codificación en Python

  • generate_code_agent

    • Se utiliza para generar código
  • execute_code

    • Se utiliza para ejecutar el código generado
  • save_code

    • Se utiliza para guardar el bloque de código en el pipeline de Arcanna como una integración

Gestión de trabajos

  • start_job

    • Iniciar la ingesta de eventos para un trabajo
  • stop_job

    • Detener la ingesta de eventos para un trabajo
  • train_job

    • Entrenar el modelo de IA del trabajo utilizando la retroalimentación proporcionada

Sistema de retroalimentación

  • add_feedback_to_event
    • Proporcionar retroalimentación sobre decisiones de IA para mejorar el modelo

Salud del sistema

  • health_check
    • Verificar el estado del servidor y la validez de la clave de API de gestión
    • Devuelve el estado de autorización de la clave de API de gestión