Claude Project Coordinator

O CPC é um servidor MCP que dá ao Claude uma visão estruturada, em disco, dos seus projetos: status, notas, stack tecnológica, atividade e saúde. Ele roda no macOS junto ao Claude Desktop, Cursor ou Claude Code. Os dados nunca saem da sua máquina.

v1.4.0 · SDK Swift MCP oficial · MIT · base de conhecimento JSON local

---

Para quem é isto?

Escolha o caminho que combina com você. Mesmo binário, primeiras perguntas diferentes.

1. Entusiasta de Swift com vários projetos

Você tem vários apps e pacotes. Trocar de contexto consome tempo, e você esquece qual repositório estava no meio de um refactor.

Comece com:

• "Adicione meu WeatherApp em ~/Developer/WeatherApp"
• "Mostre todos os meus projetos rastreados"
• "Quais projetos precisam da minha atenção?"
• "Atualize o status do WeatherApp para 'Modelos Core Data pela metade'"

O que você ganha: um registro vivo com status, notas, tecnologia detectada automaticamente (SwiftUI, SPM, projeto/workspace do Xcode) e uma pontuação de saúde para que projetos silenciosos voltem à tona.

2. Usuário diário do Claude Desktop

O Claude é a sua mesa de codificação. Você quer continuidade entre conversas sem colar a mesma lista de projetos.

Comece com:

• "Liste meus projetos e seus status atuais"
• "O que está acontecendo com o TodoApp?"
• "Encontre todos os padrões SwiftUI que armazenamos"
• "Mostre minha atividade de projetos desta semana"

O que você ganha: o Claude pode chamar nove ferramentas MCP na sua KnowledgeBase em vez de adivinhar pela memória da conversa.

3. Usuário de agente Cursor ou Claude Code

Agentes escrevem código bem, mas perdem a visão do portfólio. Você quer que o agente saiba em qual projeto está e se esse projeto está saudável.

Comece com:

• Conecte o CPC às configurações MCP do Cursor / Claude Code (veja Instalação)
• "Obtenha o status do projeto para Claude-Project-Coordinator"
• "Obtenha tendências de tecnologia em todos os meus projetos rastreados"
• "Mostre um mapa de calor de atividade de 14 dias"

O que você ganha: saúde do projeto e cronogramas como resultados de ferramenta que o agente pode usar, ao lado dos arquivos que ele já vê.

4. Configuração focada em privacidade / somente local

Você não vai enviar um inventário de projetos para uma ferramenta de gerenciamento em nuvem. Tudo deve ficar ao lado do binário.

Comece com:

• Compile a partir do código-fonte, aponte o MCP para .build/release/project-coordinator
• Opcional: CPC_KNOWLEDGE_BASE=~/Library/Application Support/CPC para dados fora da árvore git
• Mantenha KnowledgeBase/projects/*.json fora de repositórios públicos (já está no gitignore)

O que você ganha: JSON em disco, allowlist de caminhos, sem conta, sem telemetria.

5. Já usa um MCP de memória

Você armazena decisões e pessoas no Memory Service (ou similar). Não quer um segundo despejo de conversa.

Como eles se encaixam:

	CPC	Memory MCP
Função	Artefatos e status de projetos	Contexto conversacional e decisões
Forma	Ferramentas estruturadas + arquivos JSON	Notas, tags, busca
Pergunta	"Quais projetos estão desatualizados?"	"O que decidimos sobre onboarding?"

Use os dois. Não substitua um pelo outro.

---

Lista completa de recursos

Mesa de projetos

Recurso	Detalhe
Rastrear vários projetos	Nome, caminho, descrição, status, notas, tarefas atuais, última modificação
Adicionar a partir de um caminho	Valida o caminho, escaneia a pasta, armazena um registro JSON
Atualizar status / notas	Mantém a mesa atualizada sem um app separado
Listar tudo	Um prompt → registro completo com stack tecnológica
Mergulho por projeto	Status, notas, tarefas, caminho, tecnologias detectadas

Detecção automática

Quando você adiciona um projeto, o CPC inspeciona a pasta e marca o que encontra:

• Swift Package Manager (Package.swift)
• Projeto Xcode (.xcodeproj)
• Workspace Xcode (.xcworkspace)
• SwiftUI (import SwiftUI em arquivos Swift escaneados)
• Reverte para Swift quando nada mais corresponde

Busca e base de conhecimento

Recurso	Detalhe
Busca de padrões	Pesquise em projetos rastreados e no markdown da KnowledgeBase
Guias integrados	Padrões Swift, práticas SwiftUI, atalhos do Xcode, solução de problemas
Modelos	Documentos iniciais em KnowledgeBase/templates/
Seus próprios documentos	Coloque markdown em patterns/, tools/ ou templates/ e a busca vai pegar

Analytics (automático)

Nenhum app de cronômetro separado. Atualizações de status e uso de ferramentas alimentam o analytics em segundo plano.

Ferramenta	O que ela responde
get_project_timeline	Há quanto tempo este projeto está em cada status? Qual a idade dele?
get_activity_heatmap	Quais projetos estiveram em alta nos últimos N dias?
get_technology_trends	Quais frameworks dominam? O que está emergindo?
get_project_health	Pontuação de 0–100 mais recomendações (atividade, atualização, documentação, tarefas)

Exemplo de saída no chat: ANALYTICS-EXAMPLES.md.

Segurança e armazenamento

Recurso	Detalhe
JSON local	KnowledgeBase/projects/ e arquivos de analytics no seu Mac
Allowlist de caminhos	Apenas dentro das raízes configuradas (padrão: Developer, Documents, GitHub, Projects, …)
Limites de entrada	Nome, caminho, notas e comprimento da busca limitados
Verificação de injeção	Padrões de busca filtrados para payloads tipo shell
Sobrescrita via env	CPC_KNOWLEDGE_BASE para um diretório de dados personalizado
Logs seguros para stdio	Diagnósticos vão apenas para stderr (hosts MCP são donos do stdout)

---

Todas as ferramentas MCP

Ferramenta	Parâmetros	Finalidade
list_projects	—	Listar todos os projetos rastreados
add_project	name, path, opcional description	Registrar um projeto e detectar tecnologia automaticamente
get_project_status	projectName	Detalhes completos de um projeto
update_project_status	projectName, opcional status, notes	Atualizar o registro da mesa
search_code_patterns	pattern	Buscar projetos + base de conhecimento
get_project_timeline	projectName	Histórico de status e durações
get_activity_heatmap	opcional days (padrão 7)	Mapa de calor de atividade
get_technology_trends	—	Uso de frameworks no portfólio
get_project_health	—	Pontuações de saúde e recomendações

Você fala em linguagem natural. O host mapeia suas palavras para essas ferramentas.

---

Fluxo de trabalho de exemplo

You: Add my new SwiftUI project FinanceTracker at ~/Developer/FinanceTracker
Claude: Successfully added… Detected tech stack: Swift Package Manager, SwiftUI

You: Update FinanceTracker status to 'Working on Core Data models'
Claude: Updated.

You: Which of my projects use Core Data or SwiftUI?
Claude: [search + roster]

You: Which projects need my attention?
Claude: [health report with scores and recommendations]

You: Show my activity this week
Claude: [heat map]

---

Pré-requisitos

• macOS 13+
• Swift 6.0+ (Xcode 16+)
• Um host MCP: Claude Desktop, Cursor ou Claude Code

Instalação

Compilar a partir do código-fonte

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator
swift build -c release

Executável:

.build/release/project-coordinator

Claude Desktop

Configurações → Developer → Model Context Protocol:

{
  "mcpServers": {
    "project-coordinator": {
      "command": "/absolute/path/to/Claude-Project-Coordinator/.build/release/project-coordinator",
      "args": []
    }
  }
}

Cursor

Adicione a mesma entrada de servidor ao JSON de configurações MCP do seu Cursor, usando o caminho absoluto para .build/release/project-coordinator.

Claude Code

Registre o mesmo caminho de command na configuração MCP do seu Claude Code.

Opcional: defina CPC_KNOWLEDGE_BASE para um diretório KnowledgeBase personalizado (útil se o clone for público e seu JSON de projetos deva permanecer privado).

Reinicie o host após alterar a configuração.

---

Configuração de segurança

Os padrões ficam em Sources/ProjectCoordinator/SecurityValidator.swift (compilados).

Raízes permitidas: ~/Developer, ~/Documents, ~/GitHub, ~/Projects, ~/Desktop/Development, ~/Xcode

Limites: nome do projeto 100 · caminho 500 · descrição 2.000 · notas 10.000 · padrão de busca 300 caracteres

Para alterar allowlists ou limites, edite o código-fonte, recompile (swift build -c release) e reinicie o host.

---

Estrutura do projeto

Claude-Project-Coordinator/
├── Sources/
│   ├── ProjectCoordinator/     # Library (MCP, manager, analytics, security)
│   └── project-coordinator/    # Executable entry point
├── Tests/ProjectCoordinatorTests/
├── KnowledgeBase/              # Patterns, templates, local project/analytics data
├── scripts/                    # Build and repair helpers
├── ANALYTICS-EXAMPLES.md       # Sample analytics output
├── Package.swift
└── README.md

---

Atualizando da v1.3.x

1. git pull e recompile com Swift 6: swift build -c release
2. Aponte seu host MCP para o novo binário
3. Se as datas de criação foram corrompidas pelo antigo bug de re-migração:

./scripts/repair-analytics-dates.sh

---

💖 Apoie este projeto

Se o CPC ajudou a otimizar seu fluxo de desenvolvimento ou economizou seu tempo gerenciando projetos, considere apoiar seu desenvolvimento:

Seu apoio me ajuda a:

• Manter e melhorar o CPC com novos recursos
• Manter o projeto open-source e gratuito para todos
• Dedicar mais tempo a solicitações de usuários e correções de bugs
• Explorar novas ferramentas que aumentam a produtividade dos desenvolvedores

Obrigado por considerar apoiar meu trabalho! 🙏

---

Contribuindo

Contribuições são bem-vindas. Reporte bugs, sugira recursos, abra pull requests ou compartilhe padrões e modelos em KnowledgeBase/.

Licença

Licença MIT.

Agradecimentos

Construído para o ecossistema MCP. Pilha de protocolo: modelcontextprotocol/swift-sdk.

---

Feito com ❤️ de 🍍 Pineapple