CCGLM MCP Server

Servidor MCP que permite usar Claude Code con backend GLM de Z.AI desde la instancia principal de Claude Code (Anthropic Sonnet).

🎯 Propósito

Permite a Claude Code (con Sonnet de Anthropic) invocar otra instancia de Claude Code que utiliza los modelos GLM de Z.AI como backend, sin necesidad de cambiar la configuración principal.

🏗️ Arquitectura

📦 Instalación

1. Instalar Dependencias

2. Configurar Credentials

Ya está configurado en .env:

3. Registrar Servidor MCP

Añadir a ~/.claude/settings.json:

4. Configurar Alias (Opcional)

Añadir a ~/.zshrc:

Recargar:

🛠️ Herramienta Disponible

glm_route

Única herramienta del servidor CCGLM-MCP. Enruta prompt a GLM-4.6 vía Claude CLI con backend Z.AI. Maneja todos los casos de uso: generación de código, análisis profundo y consultas generales.

Uso desde Claude Code:

Uso con hashtag (configurado en CLAUDE.md):

Características:

• ✅ Generación de código con tracking de archivos

• ✅ Análisis profundo (timeout 30 minutos)

• ✅ Consultas generales

• ✅ Excluye archivos internos (.claude/, .git/, etc.) del tracking

Nota: Usa el modelo GLM-4.6 configurado en ~/.claude/settings.json.

🧪 Testing

Ejecutar tests:

Tests incluidos:

• ✅ File tracking (detección de archivos creados)

• ✅ Log sanitization (redacción de tokens)

• ⏸️ Basic prompt (comentado - requiere API call)

• ⏸️ Code generation (comentado - requiere API call)

🔒 Seguridad

• Token protegido: Almacenado en .env (gitignored)

• Logs sanitizados: Token redactado automáticamente en logs

• Environment isolation: Variables de entorno inyectadas solo en subprocess

• Permisos: .env debe tener permisos 0600

📊 Logging

Todos los logs van a stderr (no stdout) para no interferir con el protocolo MCP stdio.

Ver logs en tiempo real:

Niveles de log:

• INFO: Operaciones normales

• WARNING: Situaciones anómalas

• ERROR: Fallos

⚙️ Configuración Avanzada

Timeouts

Configurados en ccglm_mcp_server.py:

• DEFAULT_TIMEOUT = 600 (10 minutos)

• MAX_TIMEOUT = 2400 (40 minutos)

Flags de Claude CLI

El servidor ejecuta Claude CLI con:

• --dangerously-skip-permissions: Skip permissions prompts

• -c: Continue mode

• -p: Print mode (non-interactive)

🐛 Troubleshooting

Error: "claude command not found"

Verifica que Claude CLI está instalado:

Si no está, instalar:

Error: "GLM authentication failed"

Verifica que el token en .env es correcto y está activo.

Timeout errors

Si GLM tarda mucho, aumenta los timeouts en ccglm_mcp_server.py.

No aparece en herramientas MCP

1. Verifica registro en ~/.claude/settings.json

2. Reinicia Claude Code

3. Verifica logs: python3 ccglm_mcp_server.py

📝 Uso desde Terminal

Además del servidor MCP, puedes usar GLM directamente desde terminal con el alias:

🔄 Actualización

Para actualizar el servidor:

Reiniciar Claude Code para recargar el servidor MCP.

📚 Referencias

• Documentación Z.AI GLM

• MCP Protocol

• Claude Code CLI

🤝 Créditos

• Basado en patrón de ccr-mcp

• Integración con Z.AI GLM API

• Implementado como parte del ecosistema Claude hybrid system

📄 Licencia

Uso interno - No redistribuir con credentials