VitaeContext

Camada de contexto de carreira para Agentes de IA

Documentação

Servidor Stateless Model Context Protocol para contexto de carreira entre repositórios.

Conecte seu Career Context e VitaeGraph privados a assistentes de codificação de IA em qualquer workspace de projeto, sem copiar arquivos de carreira ou colar notas privadas em chats.

Por quê • Como funciona • Início rápido • Configuração do cliente • Recursos • Guia de testes • Privacidade

Servidor MCP VitaeContext

O servidor VitaeContext Model Context Protocol (MCP) fornece uma ponte stateless entre assistentes de codificação de IA e a fonte de verdade privada de carreira do usuário.

Ao registrar o servidor MCP VitaeContext na sua ferramenta de codificação de IA, agentes em qualquer workspace de projeto podem consultar imediatamente seu Career Context e VitaeGraph privados, sem precisar copiar arquivos para o repositório ou colar notas de carreira no chat.

Por que MCP para Contexto de Carreira

Ao trabalhar em vários repositórios, agentes de desenvolvimento frequentemente precisam de fatos de carreira—como escrever READMEs de perfil de repositório, redigir entradas de portfólio, preparar bios de lançamento ou atualizar documentos profissionais.

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

Principais Vantagens

Zero Poluição do Workspace: Nenhum arquivo de carreira ou documento de contexto pessoal precisa ser copiado para repositórios git individuais.
Fundamentação Imediata Entre Projetos: Qualquer ferramenta que suporte MCP pode consultar seus registros de carreira sob demanda.
Sempre Atualizado: Edições feitas em ~/.vitaecontext/career-context.md ou ~/.vitaecontext/vitaegraph/ são refletidas imediatamente em todos os chats de agentes.
Limitado por Evidências: Expõe ferramentas estruturadas que preservam fatos fornecidos e limites de evidências para a plataforma solicitada, sem afirmar verificação independente.
Zero Dependências em Tempo de Execução: Construído com Node.js ESM nativo e disponível através do pacote publicado vitaecontext via npx -y vitaecontext mcp.

Início Rápido

Execução Direta

Execute o servidor sobre entrada/saída padrão (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

Conformidade com o Protocolo

Parâmetro	Especificação
Versão do Protocolo	`2024-11-05`
Transporte	`stdio` (JSON-RPC 2.0 com enquadramento delimitado por nova linha)
Requisitos de Runtime	Node.js `>= 18.0.0`
Dependências	`0` dependências externas em tempo de execução (ESM nativo puro)
Caminhos de Descoberta	`~/.vitaecontext/career-context.md`, um arquivo de contexto correspondente inequívoco e `~/.vitaecontext/vitaegraph/`

Configurações do Cliente

Claude Desktop

Adicione ao seu 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

Adicione o servidor usando o comando MCP nativo do Claude Code:

claude mcp add vitaecontext -- npx -y vitaecontext mcp

Cursor IDE

Abra as Configurações do Cursor (Cmd+, ou Ctrl+,).
Navegue até Features -> MCP Servers.
Clique em + Add new MCP server.
Configure:
- Nome: vitaecontext
- Tipo: command
- Comando: npx -y vitaecontext mcp

Windsurf (Cascade)

Adicione ao seu ~/.codeium/windsurf/mcp_config.json:

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

Roo Code / Cline

Adicione ao seu cline_mcp_settings.json ou roo_code_mcp_settings.json:

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

Antigravity CLI

Adicione ao seu ~/.gemini/antigravity-cli/mcp_config.json:

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

IBM Bob / watsonx Code Assistant

Adicione ao seu .ibm/mcp_config.json:

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

xAI Grok

Adicione ao seu .grok/mcp_config.json:

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

Selecione dados privados explicitamente

O servidor prefere ~/.vitaecontext/career-context.md. Se esse arquivo estiver ausente e existir exatamente um arquivo *-career-context.md ou *.context.md, ele usa esse arquivo. Se houver múltiplos candidatos, o servidor retorna uma mensagem de seleção em vez de escolher um arbitrariamente.

Selecione caminhos no comando do servidor quando um cliente precisar de um local não padrão:

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

As variáveis de ambiente VITAECONTEXT_CAREER_CONTEXT e VITAEGRAPH_ROOT fornecem a mesma configuração. Argumentos de ferramentas MCP não podem alterar raízes do sistema de arquivos; o usuário controla o acesso aos arquivos ao iniciar o servidor.

Recursos

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

Recursos

URI	Descrição	Tipo MIME
`career-context://current`	Retorna o markdown privado do Career Context do usuário de `~/.vitaecontext/`.	`text/markdown`
`vitaegraph://index`	Retorna o JSON dos nós do grafo indexado de `~/.vitaecontext/vitaegraph/.generated/graph.json`.	`application/json`
`vitaegraph://record/{id}`	Lê um markdown de registro específico por ID estável (ex.: `project:local-search-engine`).	`text/markdown`
`vitaecontext://wiki/{module}`	Lê a entrada da wiki para um módulo (`vitaecontext`, `build`, `vitaegraph`).	`text/markdown`

Ferramentas

1. `get_career_context`

Recupera um pacote de Career Context limitado por evidências e mantido pelo usuário para uma superfície profissional específica.

{
  "for": "github"
}

Parâmetros:
- for (string, opcional): cv, github, linkedin, portfolio, x, general (padrão: general).

2. `search_vitaegraph`

Consulta e filtra registros de carreira estruturados no VitaeGraph privado do usuário.

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

Parâmetros:
- query (string, opcional): Pesquisa de texto sem diferenciar maiúsculas/minúsculas em ID de registro, título, tags e 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 tag exata de habilidade/tópico.

3. `validate_career_context`

Valida um arquivo de Career Context quanto à integridade estrutural, frontmatter e placeholders inacabados.

{}

Prompts

Prompt	Argumentos	Descrição
`cv_tailoring`	`targetRole` (obrigatório), `jobDescription` (opcional)	Adapta um CV para uma função alvo, preservando os limites de evidências no Career Context.
`linkedin_audit`	`profileSnapshot` (opcional)	Audita um perfil do LinkedIn contra regras de descoberta e scorecards internos.
`github_showcase`	`focus` (opcional)	Audita a estratégia de README de perfil e showcase de repositório.
`career_context_intake`	`rawNotes` (opcional)	Orienta a síntese de notas de carreira brutas em um arquivo de Career Context estruturado e mantido pelo usuário.

Como Testar o Servidor MCP

Método 1: Usando o Inspetor MCP Oficial (Interface Interativa)

O @modelcontextprotocol/inspector oficial executa um painel web visual para testar interativamente ferramentas, recursos e prompts:

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

Abra a URL exibida no terminal (geralmente http://localhost:5173).
Clique em Connect (Transporte: STDIO).
Explore e teste:
- Aba Tools: Execute get_career_context com { "for": "github" }.
- Aba Resources: Leia career-context://current ou vitaecontext://wiki/build.
- Aba Prompts: Renderize cv_tailoring com { "targetRole": "Lead Systems Architect" }.

Método 2: Piping de `stdio` via Linha de Comando

Você pode enviar payloads JSON-RPC 2.0 padrão diretamente via 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: Suíte de Testes Automatizada

Execute a suíte de testes unitários e de integração integrada:

npm test

Privacidade e Isolamento do Workspace

O servidor MCP VitaeContext é projetado em torno de privacidade local-first:

Somente Operações Locais: O servidor em execução lê apenas o Career Context local selecionado, o VitaeGraph e arquivos de wiki empacotados. Ele não faz solicitações de rede ou telemetria; npx pode contatar o npm para obter o pacote antes do lançamento.
Zero Poluição de Repositório: Arquivos de carreira privados nunca são copiados ou escritos em workspaces de projetos individuais.
Limitado por Evidências: As plataformas recebem pacotes de tarefas limitados com rótulos de evidências explícitos, reduzindo o risco de alegações sem suporte.
Runtime Stateless: Sem daemon em segundo plano, tokens ou estado persistente de banco de dados.

Especificação e Contrato

Para o contrato formal de esquema JSON-RPC 2.0, códigos de erro e detalhes de transporte, consulte schema/mcp-contract.md.

VitaeContext

Documentação

Servidor MCP VitaeContext

Por que MCP para Contexto de Carreira

Principais Vantagens

Início Rápido

Execução Direta

Conformidade com o Protocolo

Configurações do Cliente

Claude Desktop

Claude Code

Cursor IDE

Windsurf (Cascade)

Roo Code / Cline

Antigravity CLI

IBM Bob / watsonx Code Assistant

xAI Grok

Selecione dados privados explicitamente

Recursos

Recursos

Ferramentas

1. get_career_context

2. search_vitaegraph

3. validate_career_context

Prompts

Como Testar o Servidor MCP

Método 1: Usando o Inspetor MCP Oficial (Interface Interativa)

Método 2: Piping de stdio via Linha de Comando

Método 3: Suíte de Testes Automatizada

Privacidade e Isolamento do Workspace

Especificação e Contrato

1. `get_career_context`

2. `search_vitaegraph`

3. `validate_career_context`

Método 2: Piping de `stdio` via Linha de Comando