Angreal

Servidor MCP de Angreal

Un servidor MCP (Model Context Protocol) que proporciona a los asistentes de IA capacidades de descubrimiento para proyectos angreal.

Resumen

Este servidor expone la estructura de árbol de comandos de angreal a clientes compatibles con MCP, permitiendo a los asistentes de IA:

• Descubrir comandos y tareas disponibles en tu proyecto angreal
• Comprender la estructura y capacidades del proyecto
• Sugerir comandos apropiados según el contexto

Requisitos previos

• angreal debe estar instalado y disponible en tu PATH
• Cadena de herramientas de Rust (para compilar desde el código fuente)

Instalación

# Install from crates.io
cargo install angreal_mcp

# Or install from git (latest development version)
cargo install --git https://github.com/colliery-io/angreal-mcp

Uso

Con Claude Code

Crea o actualiza tu archivo de configuración MCP de Claude Code en ~/.config/claude-code/mcp_servers.json:

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "env": {}
    }
  }
}

Con Claude Desktop

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "cwd": "/path/to/your/angreal/project"
    }
  }
}

Con Cline (VS Code)

Añade a tu configuración de Cline:

{
  "mcp": {
    "servers": [
      {
        "name": "angreal",
        "command": ["angreal_mcp"],
        "cwd": "${workspaceFolder}"
      }
    ]
  }
}

Pruebas desde la línea de comandos

Puedes probar el servidor MCP directamente desde la línea de comandos:

# List available tools
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | angreal_mcp

# Get angreal command tree
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "angreal_tree", "arguments": {"format": "json"}}}' | angreal_mcp

Herramientas disponibles

angreal_check

Comprueba si el directorio actual es un proyecto angreal y obtén el estado del proyecto, incluidos los comandos disponibles.

angreal_tree

Obtén una vista estructurada de todos los comandos y tareas angreal disponibles en el proyecto.

Parámetros:

• format (opcional): Formato de salida - "json" (predeterminado) o "human"

angreal_run

Ejecuta un comando o tarea angreal con argumentos opcionales.

Parámetros:

• command (obligatorio): El comando/tarea angreal a ejecutar
• args (opcional): Argumentos y banderas adicionales

Guía de uso para agentes

Cuando trabajes en proyectos angreal, usa estas herramientas para el descubrimiento y ejecución inteligente de comandos:

Flujo de trabajo de uso de herramientas

1. Comienza con el descubrimiento: Usa angreal_check para verificar el estado y las capacidades del proyecto
2. Explora comandos: Usa angreal_tree para ver los comandos disponibles con metadatos enriquecidos
3. Ejecuta de forma inteligente: Usa angreal_run con selección de parámetros consciente del contexto

Mejores prácticas

• Siempre revisa las guías de when_to_use y when_not_to_use de angreal_tree
• Usa las recomendaciones de parámetros (recommended_when) para obtener mejores resultados
• Verifica los requisitos previos antes de ejecutar comandos
• Deja que la salida del comando y los códigos de salida guíen la validación de éxito

Patrones comunes

• Flujos de configuración: Ejecuta comandos de configuración/instalación antes de los comandos de compilación/prueba
• Ciclos de desarrollo: Usa comandos de prueba después de cambios de código, comandos de compilación antes del despliegue
• Selección de parámetros: Usa banderas verbosas al depurar, banderas de producción para lanzamientos

Solución de problemas

• Si el servidor MCP no está disponible, reinicia Claude Code para reinicializarlo
• Verifica que el binario angreal esté instalado y accesible en PATH
• Verifica que estás en un directorio de proyecto angreal (contiene la carpeta .angreal/)

El servidor MCP de angreal proporciona metadatos de comandos mejorados, incluido el contexto de uso, la guía de parámetros y la categorización inteligente para permitir mejores decisiones de automatización.

Desarrollo

Ejecución de pruebas

Este proyecto usa angreal como su ejecutor de pruebas:

# Run tests using angreal
angreal test

Estructura del proyecto

angreal_mcp/
├── src/
│   ├── main.rs      # Main server loop
│   ├── mcp.rs       # MCP protocol implementation
│   └── angreal.rs   # Angreal integration
├── examples/        # Configuration examples
└── tests/          # Integration tests

Compilación

# Debug build
cargo build

# Release build
cargo build --release

Licencia

Este proyecto tiene doble licencia bajo MIT OR Apache-2.0.