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
|
- ✅ Traefik para proxy reverso y SSL
|
||||||
- ✅ Claude Code hooks para monitoreo de Actions
|
- ✅ Claude Code hooks para monitoreo de Actions
|
||||||
- ✅ MCP Server Docker para gestión de contenedores
|
- ✅ MCP Server Docker para gestión de contenedores
|
||||||
|
- ✅ MCP Server Gitea para API de Gitea
|
||||||
|
|
||||||
## Servicios
|
## Servicios
|
||||||
|
|
||||||
@@ -40,11 +41,97 @@ Servidor MCP personalizado construido con TypeScript que expone operaciones Dock
|
|||||||
- Usa el puerto 3000 para comunicación HTTP
|
- Usa el puerto 3000 para comunicación HTTP
|
||||||
- Tiene acceso al socket de Docker del host (solo lectura)
|
- Tiene acceso al socket de Docker del host (solo lectura)
|
||||||
- Se ejecuta en las redes `principal` y `traefik-network`
|
- 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
|
- Prioridad 200 en Traefik para evitar conflictos con otros routers
|
||||||
- Endpoints disponibles:
|
- Endpoints disponibles:
|
||||||
- `POST /mcp` - Protocolo MCP para operaciones Docker
|
- `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
|
## Desarrollo Local
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user