convez.ai
MCP ServerProdutividadeIntermediário
Naraujo13

Claude Code Profiles

Naraujo13/claude-code-profiles

Gerencie múltiplos perfis de Claude Code isolados sem tocar em settings.json

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que gerencia perfis nomeados para Claude Code, permitindo diferentes conjuntos de ferramentas por sessão sem modificar arquivos de configuração. Ideal para desenvolvedores que trabalham com múltiplos contextos (infra, web, pesquisa) em paralelo.

Instalação

$npx convez-ai Naraujo13/claude-code-profiles

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v1.0.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar sessões paralelas de Claude com diferentes toolsets (infra, código, pesquisa)
  • Reduzir context clutter removendo MCPs irrelevantes para cada tarefa
  • Alternar entre configurações de desenvolvimento sem reconfiguração manual

Veredito

Ferramenta prática que resolve um problema real: gerenciar múltiplos contextos MCP sem poluição. A implementação é limpa (temp files, cleanup automático) e bem documentada, mas requer familiaridade com CLI e estrutura de perfis JSON.

README

A tradução para o português deste README ainda está na fila.

claude-code-profiles

Claude Code loads every MCP server and plugin you have configured. As your setup grows, that can become context clutter with irrelevant toolings for different situations.

ccp lets you define named profiles and launch Claude with only what that context needs. Run multiple sessions in parallel, each with a different profile, without touching your settings.json.

ccp infra      # terminal 1: claude with k8s, pagerduty, terraform
ccp code       # terminal 2: claude with github, lsp, docs
ccp research   # terminal 3: claude with search and notes only

Each runs independently with its own isolated tool set, allowing for different setups in parallel sessions.

Install

uv tool install claude-code-profiles

Requires Python 3.9+ and Claude Code.

Quickstart

ccp create <profile>   # opens editor pre-filled with all your MCPs and plugins
                       # remove what you don't want, save and close
ccp <profile>          # launch claude with that profile

Commands

ccp list              # list profiles
ccp show <name>       # inspect a profile
ccp create <name>     # create a new profile
ccp edit <name>       # edit an existing profile
ccp remove <name>     # delete a profile
ccp <name> [args...]  # launch claude with profile applied

Profile format

{
  "description": "Coding — GitHub and docs only",
  "enabledMcpjsonServers": ["github", "filesystem"],
  "enabledPlugins": ["context7@claude-plugins-official"]
}

Profiles live in ~/.claude/profiles/ by default. Override with $CCP_PROFILES_DIR.

How it works

When you run ccp <name>, it builds a filtered MCP config from your profile and launches Claude with --mcp-config --strict-mcp-config --settings, using temp files that are cleaned up after the session. Nothing is written to your settings.

MCP definitions are discovered from ~/.claude.json, ~/.claude/settings.json, and .mcp.json files walked up from your current directory.

Ver o original no GitHub

Bom para

Relacionados