VitaeContext

Capa de contexto profesional para agentes de IA

Documentación

Servidor de Protocolo de Contexto de Modelo (MCP) sin estado para contexto profesional entre repositorios.

Conecta tu Contexto Profesional privado y VitaeGraph a asistentes de codificación con IA en cualquier espacio de trabajo de proyecto sin copiar archivos profesionales ni pegar notas privadas en chats.

Por qué • Cómo funciona • Inicio rápido • Configuración del cliente • Capacidades • Guía de pruebas • Privacidad

Servidor MCP de VitaeContext

El servidor de Protocolo de Contexto de Modelo (MCP) de VitaeContext proporciona un puente sin estado entre asistentes de codificación con IA y la fuente de verdad profesional privada de un usuario.

Al registrar el servidor MCP de VitaeContext en tu herramienta de codificación con IA, los agentes en cualquier espacio de trabajo de proyecto pueden consultar inmediatamente tu Contexto Profesional privado y VitaeGraph sin necesidad de copiar archivos al repositorio ni pegar notas profesionales en el chat.

Por qué MCP para Contexto Profesional

Al trabajar en múltiples repositorios, los agentes de desarrollo frecuentemente necesitan datos profesionales, como escribir READMEs de perfil de repositorio, redactar entradas de portafolio, preparar biografías de lanzamiento o actualizar documentos profesionales.

VitaeContext MCP Architecture: Stateless bridge between developer coding workspaces and private career context

Ventajas Clave

Cero Contaminación del Espacio de Trabajo: No es necesario copiar archivos profesionales ni documentos de contexto personal en repositorios git individuales.
Fundamentación Instantánea entre Proyectos: Cualquier herramienta compatible con MCP puede consultar tus registros profesionales bajo demanda.
Siempre Actualizado: Las ediciones realizadas en ~/.vitaecontext/career-context.md o ~/.vitaecontext/vitaegraph/ se reflejan inmediatamente en todos los chats de agentes.
Limitado por Evidencia: Expone herramientas estructuradas que preservan los hechos proporcionados y los límites de evidencia para la plataforma solicitada sin afirmar verificación independiente.
Cero Dependencias en Tiempo de Ejecución: Construido con Node.js ESM nativo y disponible a través del paquete publicado vitaecontext mediante npx -y vitaecontext mcp.

Inicio Rápido

Ejecución Directa

Ejecuta el servidor sobre entrada/salida estándar (stdio JSON-RPC 2.0):

# Using npx (downloads the published package when needed)
npx -y vitaecontext mcp

# Or after installing the vitaecontext package
vitaecontext mcp

Conformidad del Protocolo

Parámetro	Especificación
Versión del Protocolo	`2024-11-05`
Transporte	`stdio` (JSON-RPC 2.0 con delimitación por nueva línea)
Requisitos de Ejecución	Node.js `>= 18.0.0`
Dependencias	`0` dependencias externas en tiempo de ejecución (ESM nativo puro)
Rutas de Descubrimiento	`~/.vitaecontext/career-context.md`, un archivo de contexto coincidente sin ambigüedad, y `~/.vitaecontext/vitaegraph/`

Configuraciones del Cliente

Claude Desktop

Agrega a tu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

Claude Code

Agrega el servidor usando el comando MCP nativo de Claude Code:

claude mcp add vitaecontext -- npx -y vitaecontext mcp

Cursor IDE

Abre Configuración de Cursor (Cmd+, o Ctrl+,).
Navega a Funciones -> Servidores MCP.
Haz clic en + Agregar nuevo servidor MCP.
Configura:
- Nombre: vitaecontext
- Tipo: command
- Comando: npx -y vitaecontext mcp

Windsurf (Cascade)

Agrega a tu ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

Roo Code / Cline

Agrega a tu cline_mcp_settings.json o roo_code_mcp_settings.json:

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

Antigravity CLI

Agrega a tu ~/.gemini/antigravity-cli/mcp_config.json:

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

IBM Bob / watsonx Code Assistant

Agrega a tu .ibm/mcp_config.json:

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

xAI Grok

Agrega a tu .grok/mcp_config.json:

{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext", "mcp"]
    }
  }
}

Seleccionar datos privados explícitamente

El servidor prefiere ~/.vitaecontext/career-context.md. Si ese archivo está ausente y existe exactamente un archivo *-career-context.md o *.context.md, usa ese archivo. Si existen múltiples candidatos, el servidor devuelve un mensaje de selección en lugar de elegir uno arbitrariamente.

Selecciona rutas en el comando del servidor cuando un cliente necesite una ubicación no predeterminada:

npx -y vitaecontext mcp --context /private/path/career-context.md --root /private/path/vitaegraph

Las variables de entorno VITAECONTEXT_CAREER_CONTEXT y VITAEGRAPH_ROOT proporcionan la misma configuración. Los argumentos de las herramientas MCP no pueden cambiar las raíces del sistema de archivos; el usuario controla el acceso a archivos al iniciar el servidor.

Capacidades

VitaeContext MCP Capabilities: Structured resources, tools, and prompts for grounded AI work

Recursos

URI	Descripción	Tipo MIME
`career-context://current`	Devuelve el Contexto Profesional privado del usuario en markdown desde `~/.vitaecontext/`.	`text/markdown`
`vitaegraph://index`	Devuelve el JSON de nodos de grafo indexado desde `~/.vitaecontext/vitaegraph/.generated/graph.json`.	`application/json`
`vitaegraph://record/{id}`	Lee un registro específico en markdown por ID estable (p. ej. `project:local-search-engine`).	`text/markdown`
`vitaecontext://wiki/{module}`	Lee la entrada de wiki para un módulo (`vitaecontext`, `build`, `vitaegraph`).	`text/markdown`

Herramientas

1. `get_career_context`

Recupera un paquete de Contexto Profesional limitado por evidencia y mantenido por el usuario para una superficie profesional específica.

{
  "for": "github"
}

Parámetros:
- for (string, opcional): cv, github, linkedin, portfolio, x, general (predeterminado: general).

2. `search_vitaegraph`

Consulta y filtra registros profesionales estructurados en el VitaeGraph privado del usuario.

{
  "query": "distributed systems",
  "type": "project",
  "tag": "nodejs"
}

Parámetros:
- query (string, opcional): Búsqueda de texto sin distinción de mayúsculas/minúsculas en ID de registro, título, etiquetas y texto de registro indexado.
- type (string, opcional): Filtra por tipo de registro (experience, project, education, course, thesis, certification, award, publication).
- tag (string, opcional): Filtra por etiqueta exacta de habilidad/tema.

3. `validate_career_context`

Valida un archivo de Contexto Profesional para integridad estructural, frontmatter y marcadores de posición sin completar.

{}

Prompts

Prompt	Argumentos	Descripción
`cv_tailoring`	`targetRole` (obligatorio), `jobDescription` (opcional)	Adapta un CV a un rol objetivo preservando los límites de evidencia en el Contexto Profesional.
`linkedin_audit`	`profileSnapshot` (opcional)	Audita un perfil de LinkedIn según reglas de descubribilidad y cuadros de mando internos.
`github_showcase`	`focus` (opcional)	Audita el README de perfil y la estrategia de exhibición del repositorio.
`career_context_intake`	`rawNotes` (opcional)	Guía la síntesis de notas profesionales en bruto en un archivo de Contexto Profesional estructurado y mantenido por el usuario.

Cómo Probar el Servidor MCP

Método 1: Usando el Inspector MCP Oficial (Interfaz Interactiva)

El @modelcontextprotocol/inspector oficial ejecuta un panel web visual para probar interactivamente herramientas, recursos y prompts:

# Launch the MCP inspector
npx @modelcontextprotocol/inspector npx -y vitaecontext mcp

Abre la URL mostrada en la terminal (generalmente http://localhost:5173).
Haz clic en Conectar (Transporte: STDIO).
Explora y prueba:
- Pestaña Herramientas: Ejecuta get_career_context con { "for": "github" }.
- Pestaña Recursos: Lee career-context://current o vitaecontext://wiki/build.
- Pestaña Prompts: Renderiza cv_tailoring con { "targetRole": "Lead Systems Architect" }.

Método 2: Piping de `stdio` por Línea de Comandos

Puedes enviar cargas útiles JSON-RPC 2.0 estándar directamente a través de stdin:

# 1. Initialize Handshake
printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"tester","version":"1.0.0"}}}\n' | npx -y vitaecontext mcp

# 2. List Available Tools
printf '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' | npx -y vitaecontext mcp

# 3. Call get_career_context Tool
printf '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_career_context","arguments":{"for":"cv"}}}\n' | npx -y vitaecontext mcp

Método 3: Suite de Pruebas Automatizadas

Ejecuta la suite de pruebas unitarias e integración integrada:

npm test

Privacidad y Aislamiento del Espacio de Trabajo

El servidor MCP de VitaeContext está diseñado en torno a la privacidad local primero:

Solo Operaciones Locales: El servidor en ejecución lee solo el Contexto Profesional local seleccionado, VitaeGraph y archivos de wiki empaquetados. No realiza solicitudes de red ni telemetría; npx puede contactar a npm para obtener el paquete antes del lanzamiento.
Cero Contaminación del Repositorio: Los archivos profesionales privados nunca se copian ni escriben en espacios de trabajo de proyectos individuales.
Limitado por Evidencia: Las plataformas reciben paquetes de tareas limitados con etiquetas de evidencia explícitas, reduciendo el riesgo de afirmaciones sin respaldo.
Ejecución Sin Estado: Sin demonio en segundo plano, tokens ni estado persistente de base de datos.

Especificación y Contrato

Para el contrato formal de esquema JSON-RPC 2.0, códigos de error y detalles de transporte, consulta schema/mcp-contract.md.