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

Propsito

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 configuracin principal.

Arquitectura

Claude Code (Sonnet Anthropic)
    
MCP Tool: mcp__ccglm-mcp__glm_route
    
CCGLM MCP Server
    
Claude CLI con env vars GLM
    
Z.AI GLM API (https://api.z.ai/api/anthropic)
    
Modelo GLM-4.6

Instalacin

1. Instalar Dependencias

cd ~/IA/ccglm-mcp
pip install -r requirements.txt

2. Configurar Credentials

Ya est configurado en .env:

GLM_BASE_URL=https://api.z.ai/api/anthropic
GLM_AUTH_TOKEN=5951e8ffb37b4f038ba9a47f49e86ff4.ZYOeeSK1MWARJ8YB

3. Registrar Servidor MCP

Aadir a ~/.claude/settings.json:

{
  "mcpServers": {
    "ccglm-mcp": {
      "command": "python3",
      "args": ["/home/manu/IA/ccglm-mcp/ccglm_mcp_server.py"],
      "timeout": 300000
    }
  }
}

4. Configurar Alias (Opcional)

Aadir a ~/.zshrc:

# Z.AI GLM Integration
export GLM_API_TOKEN="5951e8ffb37b4f038ba9a47f49e86ff4.ZYOeeSK1MWARJ8YB"
alias ccglm='ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic ANTHROPIC_AUTH_TOKEN=$GLM_API_TOKEN claude --dangerously-skip-permissions -c'

Recargar:

source ~/.zshrc

Herramienta Disponible

glm_route

nica herramienta del servidor CCGLM-MCP. Enruta prompt a GLM-4.6 va Claude CLI con backend Z.AI. Maneja todos los casos de uso: generacin de cdigo, anlisis profundo y consultas generales.

Uso desde Claude Code:

Usa la herramienta mcp__ccglm-mcp__glm_route con el prompt: "Tu tarea aqu"

Uso con hashtag (configurado en CLAUDE.md):

#ccglm Explica qu es recursin
#ccglm Genera una API REST en Python
#ccglm Analiza este cdigo en detalle

Caractersticas:

• Generacin de cdigo con tracking de archivos
• Anlisis 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:

cd ~/IA/ccglm-mcp
python3 test_server.py

Tests incluidos:

• File tracking (deteccin de archivos creados)
• Log sanitization (redaccin 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 automticamente 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:

python3 /home/manu/IA/ccglm-mcp/ccglm_mcp_server.py 2>&1 | grep -i glm

Niveles de log:

• INFO: Operaciones normales
• WARNING: Situaciones anmalas
• ERROR: Fallos

Configuracin 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:

claude --dangerously-skip-permissions -c -p

• --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:

which claude

Si no est, instalar:

npm install -g @anthropic-ai/claude-code

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

Adems del servidor MCP, puedes usar GLM directamente desde terminal con el alias:

# Uso interactivo
ccglm

# Con prompt directo
echo "Explain recursion" | ccglm

Actualizacin

Para actualizar el servidor:

cd ~/IA/ccglm-mcp
git pull  # Si est en git
pip install -r requirements.txt --upgrade

Reiniciar Claude Code para recargar el servidor MCP.

Referencias

• Documentacin Z.AI GLM
• MCP Protocol
• Claude Code CLI

Crditos

• Basado en patrn de ccr-mcp
• Integracin con Z.AI GLM API
• Implementado como parte del ecosistema Claude hybrid system

Licencia

Uso interno - No redistribuir con credentials