Actualizar README con información de conexión a Claude Code
- Agregada sección de Conexión a Claude Code con comandos - Documentado MCP Gitea Server completo - Actualizada URL de MCP Docker Server a docker.nucleoriofrio.com - Agregados ejemplos de uso y scopes disponibles
This commit is contained in:
91
README.md
91
README.md
@@ -28,6 +28,7 @@ Este repositorio contiene la documentación del funcionamiento del sistema Nucle
|
||||
- ✅ Traefik para proxy reverso y SSL
|
||||
- ✅ Claude Code hooks para monitoreo de Actions
|
||||
- ✅ MCP Server Docker para gestión de contenedores
|
||||
- ✅ MCP Server Gitea para API de Gitea
|
||||
|
||||
## Servicios
|
||||
|
||||
@@ -40,11 +41,97 @@ Servidor MCP personalizado construido con TypeScript que expone operaciones Dock
|
||||
- Usa el puerto 3000 para comunicación HTTP
|
||||
- Tiene acceso al socket de Docker del host (solo lectura)
|
||||
- Se ejecuta en las redes `principal` y `traefik-network`
|
||||
- **Expuesto públicamente en `APP_DOMAIN/mcp` SIN autenticación Authentik**
|
||||
- **Expuesto públicamente en `docker.nucleoriofrio.com/mcp` SIN autenticación Authentik**
|
||||
- Prioridad 200 en Traefik para evitar conflictos con otros routers
|
||||
- Endpoints disponibles:
|
||||
- `POST /mcp` - Protocolo MCP para operaciones Docker
|
||||
- `GET /mcp/health` - Health check del servicio
|
||||
- `GET /health` - Health check del servicio
|
||||
|
||||
### MCP Gitea Server (`mcp-gitea`)
|
||||
Servidor MCP personalizado construido con TypeScript que expone la API de Gitea a través del protocolo MCP sobre HTTP. Este servicio:
|
||||
- Implementa 5 herramientas optimizadas para Gitea API v1
|
||||
- Usa el puerto 3000 para comunicación HTTP
|
||||
- Se conecta a Gitea mediante URL interna (http://gitea:3000)
|
||||
- Se ejecuta en las redes `principal` y `traefik-network`
|
||||
- **Expuesto públicamente en `gitea.nucleoriofrio.com/mcp` SIN autenticación Authentik**
|
||||
- Prioridad 200 en Traefik para evitar conflictos con otros routers
|
||||
- Herramientas disponibles:
|
||||
- `gitea_repos` - Gestión de repositorios
|
||||
- `gitea_commits` - Operaciones con commits
|
||||
- `gitea_issues` - Manejo de issues
|
||||
- `gitea_secrets` - Gestión de secrets para Actions
|
||||
- `gitea_variables` - Gestión de variables para Actions
|
||||
- Endpoints disponibles:
|
||||
- `POST /mcp` - Protocolo MCP para operaciones Gitea
|
||||
- `GET /health` - Health check del servicio
|
||||
|
||||
## Conexión a Claude Code
|
||||
|
||||
Para conectar los servidores MCP a Claude Code, utiliza los siguientes comandos:
|
||||
|
||||
### 1. MCP Docker Server
|
||||
|
||||
```bash
|
||||
claude mcp add --transport http nucleodocs-docker https://docker.nucleoriofrio.com/mcp
|
||||
```
|
||||
|
||||
### 2. MCP Gitea Server
|
||||
|
||||
```bash
|
||||
claude mcp add --transport http nucleodocs-gitea https://gitea.nucleoriofrio.com/mcp
|
||||
```
|
||||
|
||||
### Verificación
|
||||
|
||||
Después de agregar los servidores, puedes verificar que estén configurados correctamente:
|
||||
|
||||
```bash
|
||||
# Listar todos los servidores configurados
|
||||
claude mcp list
|
||||
|
||||
# Ver detalles de un servidor específico
|
||||
claude mcp get nucleodocs-docker
|
||||
claude mcp get nucleodocs-gitea
|
||||
|
||||
# Dentro de Claude Code, verificar el estado
|
||||
/mcp
|
||||
```
|
||||
|
||||
### Uso
|
||||
|
||||
Una vez agregados, podrás usar las herramientas directamente en Claude Code:
|
||||
|
||||
**Para Docker:**
|
||||
```
|
||||
> Lista todos los contenedores en ejecución
|
||||
> Muestra los logs del contenedor nucleodocs-mcp-gitea
|
||||
> Inspecciona el contenedor de traefik
|
||||
```
|
||||
|
||||
**Para Gitea:**
|
||||
```
|
||||
> Lista mis repositorios de Gitea
|
||||
> Muestra los últimos commits del repo nucleoDocs
|
||||
> Busca issues abiertos en el repositorio analiticaNucleo
|
||||
```
|
||||
|
||||
### Scopes disponibles
|
||||
|
||||
Si quieres compartir estos servidores con todo el equipo, puedes agregarlos con scope `project`:
|
||||
|
||||
```bash
|
||||
# Para compartir con el equipo (crea .mcp.json en el proyecto)
|
||||
claude mcp add --transport http nucleodocs-docker --scope project https://docker.nucleoriofrio.com/mcp
|
||||
claude mcp add --transport http nucleodocs-gitea --scope project https://gitea.nucleoriofrio.com/mcp
|
||||
```
|
||||
|
||||
O si los quieres disponibles en todos tus proyectos personales:
|
||||
|
||||
```bash
|
||||
# Para uso personal en todos los proyectos
|
||||
claude mcp add --transport http nucleodocs-docker --scope user https://docker.nucleoriofrio.com/mcp
|
||||
claude mcp add --transport http nucleodocs-gitea --scope user https://gitea.nucleoriofrio.com/mcp
|
||||
```
|
||||
|
||||
## Desarrollo Local
|
||||
|
||||
|
||||
Reference in New Issue
Block a user