nucleo000/nucleoDocs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reorganizar instalación MCPs al inicio del README
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 11s
Details

Browse Source 
- Movida sección de instalación al principio del documento
- Corregido comando chrome-devtools: usar -- para args
- Consolidada información de scopes y verificación
- Eliminadas secciones duplicadas
- Mejorada estructura para acceso rápido
This commit is contained in:
josedario87
2025-10-27 15:41:07 -06:00
parent eb7e97421f
commit b57ac8de83
1 changed files with 51 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files

112
README.md
View File

@@ -2,6 +2,55 @@
Sistema de documentación para el ecosistema Nucleo basado en Nuxt 4 con autenticación mediante Authentik Proxy Outpost.
## Instalación de Servidores MCP
Para conectar los servidores MCP a Claude Code, ejecuta los siguientes comandos:
### MCP Docker Server
```bash
claude mcp add --transport http nucleodocs-docker https://docker.nucleoriofrio.com/mcp
```
### MCP Gitea Server
```bash
claude mcp add --transport http nucleodocs-gitea https://gitea.nucleoriofrio.com/mcp
```
### MCP Chrome DevTools
```bash
claude mcp add chrome-devtools npx -- chrome-devtools-mcp@latest --isolated=true
```
### Scopes Disponibles
**Para compartir con el equipo** (crea .mcp.json en el proyecto):
```bash
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
claude mcp add chrome-devtools --scope project npx -- chrome-devtools-mcp@latest --isolated=true
```
**Para uso personal en todos los proyectos**:
```bash
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
claude mcp add chrome-devtools --scope user npx -- chrome-devtools-mcp@latest --isolated=true
```
### Verificación
```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
claude mcp get chrome-devtools
# Dentro de Claude Code, verificar el estado
/mcp
```
## Propósito
Este repositorio contiene la documentación del funcionamiento del sistema Nucleo, incluyendo:
@@ -66,48 +115,9 @@ Servidor MCP personalizado construido con TypeScript que expone la API de Gitea
- `POST /mcp` - Protocolo MCP para operaciones Gitea
- `GET /health` - Health check del servicio
## Conexión a Claude Code
## Ejemplos de Uso
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
```
### 3. MCP Chrome DevTools
```bash
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest --isolated=true
```
### 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
claude mcp get chrome-devtools
# Dentro de Claude Code, verificar el estado
/mcp
```
### Uso
Una vez agregados, podrás usar las herramientas directamente en Claude Code:
Una vez agregados los servidores MCP, podrás usar las herramientas directamente en Claude Code:
**Para Docker:**
```
@@ -130,26 +140,6 @@ Una vez agregados, podrás usar las herramientas directamente en Claude Code:
> Toma una captura de pantalla de la página actual
```
### 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
claude mcp add chrome-devtools --scope project npx chrome-devtools-mcp@latest --isolated=true
```
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
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest --isolated=true
```
## Desarrollo Local
```bash