📚 Gentleman Book MCP Server

Dale a los asistentes de IA acceso directo al Gentleman Programming Book

Características • Instalación • Configuración • Uso • English

¿Qué es esto?

Este es un servidor MCP (Model Context Protocol) que permite a asistentes de IA como Claude leer, buscar y entender el contenido del Gentleman Programming Book.

Pensalo como darle a tu asistente de IA una línea directa a 18 capítulos de conocimiento sobre arquitectura de software, buenas prácticas y sabiduría de desarrollo.

Características

🔧 Nivel 1: Tools Básicos

📦 Nivel 2: Resources y Prompts

🧠 Nivel 3: Búsqueda Semántica (IA)

Soporta tanto OpenAI como Ollama para generación de embeddings.

Instalación

Prerequisitos

• Go 1.21 o superior
• El Gentleman Programming Book clonado localmente

Compilar desde source

# Clonar este repositorio
git clone https://github.com/Alan-TheGentleman/gentleman-book-mcp.git
cd gentleman-book-mcp

# Compilar el binario
go build -o bin/gentleman-book-mcp ./cmd/server

# El binario está en ./bin/gentleman-book-mcp

Verificar instalación

./bin/gentleman-book-mcp --help

Configuración

Variables de Entorno

Configuración en Claude Desktop

Agregar a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "gentleman-book": {
      "command": "/ruta/absoluta/a/gentleman-book-mcp",
      "env": {
        "BOOK_PATH": "/ruta/a/gentleman-programming-book/src/data/book"
      }
    }
  }
}

Con OpenAI (para búsqueda semántica)

{
  "mcpServers": {
    "gentleman-book": {
      "command": "/ruta/absoluta/a/gentleman-book-mcp",
      "env": {
        "BOOK_PATH": "/ruta/a/gentleman-programming-book/src/data/book",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Con Ollama (gratis, local)

1. Instalar Ollama
2. Descargar un modelo de embeddings: ollama pull nomic-embed-text
3. Iniciar Ollama: ollama serve
4. Usar la configuración estándar (Ollama se auto-detecta)

Uso

Una vez configurado, reiniciá Claude Desktop y empezá a chatear!

Ejemplos de conversación

Listar capítulos:

Vos: ¿Qué capítulos tiene el Gentleman Programming Book?
Claude: [Usa list_chapters] El libro tiene 18 capítulos cubriendo...

Leer contenido específico:

Vos: Leeme el capítulo sobre arquitectura hexagonal
Claude: [Usa read_chapter] Acá está el capítulo de arquitectura hexagonal...

Buscar temas:

Vos: Buscá información sobre TDD en el libro
Claude: [Usa search_book] Encontré varias menciones de TDD...

Búsqueda semántica (si está configurada):

Vos: ¿Cómo debería estructurar una aplicación React para que sea mantenible?
Claude: [Usa semantic_search] Basándome en las recomendaciones del libro...

Usar prompts:

Vos: Explicame clean architecture según el libro
Claude: [Usa explain_concept prompt] Según el Gentleman Programming Book...

Contenido del Libro

El servidor provee acceso a 18 capítulos en inglés y español:

Arquitectura

gentleman-book-mcp/
├── cmd/
│   └── server/
│       └── main.go              # Entry point del servidor MCP
├── internal/
│   ├── book/
│   │   ├── models.go            # Estructuras de datos
│   │   └── parser.go            # Parser de archivos MDX
│   └── embeddings/
│       └── embeddings.go        # Motor de búsqueda semántica
├── go.mod
├── go.sum
├── README.md                    # Documentación en inglés
└── README.es.md                 # Documentación en español

Desarrollo

# Correr en modo desarrollo
go run ./cmd/server

# Compilar
go build -o bin/gentleman-book-mcp ./cmd/server

# Testear con MCP Inspector
npx @anthropic-ai/mcp-inspector ./bin/gentleman-book-mcp

Troubleshooting

"Book path does not exist"

Asegurate que la variable BOOK_PATH apunte a la ubicación correcta de los archivos MDX del libro.

"Semantic search not available"

O seteá OPENAI_API_KEY o asegurate que Ollama esté corriendo con un modelo de embeddings instalado.

El servidor no responde

Verificá que el binario tenga permisos de ejecución: chmod +x ./bin/gentleman-book-mcp

Contribuir

¡Las contribuciones son bienvenidas! Podés:

• Reportar bugs
• Sugerir nuevas features
• Enviar pull requests

Licencia

MIT License - ver LICENSE para detalles.

Proyectos Relacionados

• Gentleman Programming Book - El libro
• Model Context Protocol - Especificación MCP
• mcp-go - SDK de Go para MCP

Hecho con ❤️ por Gentleman Programming