XCF Xcode MCP Server

Um servidor MCP baseado em Swift que se integra ao Xcode para aprimorar fluxos de trabalho de desenvolvimento com IA.

Documentação

🚀 XCF Xcode MCP Server

O jeito Swift de turbinar seu fluxo de trabalho com IA!

🖌️ Novidades na versão 1.0.6

Um servidor MCP mais enxuto, focado em automação de projetos Xcode, leitura de arquivos, navegação de diretórios, análise Swift e trechos de código.
Removidas as ferramentas de diff, edição de código e documentos Xcode do servidor MCP, junto com a dependência MultiLineDiff (D1F).
Pacotes DMG e ZIP para download, com um atalho de Applications no DMG para instalação por arrastar e soltar.
Aplicativo macOS universal para Apple silicon e Intel, com suporte a macOS 13.5 ou posterior.
Correções de compatibilidade para builds empacotados: xcf-swift fixado na versão 1.0.0 e chamadas MCP adaptadas ao SDK atualizado.

Atualização: use as ferramentas nativas de edição do seu cliente para operações removidas do XCF. Substitua o aplicativo e reinicie seu cliente MCP para recarregar a lista de ferramentas.

Notas de versão · Mudanças desde a 1.0.5

Acelere a criação de aplicativos Xcode com o xcf, um servidor MCP baseado em Swift, extremamente simples, projetado para Cursor, Claude Code e VSCode — sem TypeScript, sem JavaScript, sem enrolação!

🧰 Instalação e Configuração do XCF

Downloads

Pacote	Instalação
XCF 1.0.6 — DMG para macOS	Recomendado: abra a imagem e arraste xcf.app para o atalho Applications.
XCF 1.0.6 — ZIP para macOS	Extraia o arquivo e mova xcf.app para /Applications.

O alvo mínimo de implantação do aplicativo empacotado é macOS 13.5, verificado nos executáveis arm64 e x86_64. Testes em tempo de execução no macOS 13.5 não foram realizados.

Etapas de Instalação

Instale o XCF usando um dos downloads acima.
Inicie o aplicativo para aprovar o download da internet.

Você verá o seguinte alerta (isso é esperado):

Clique no botão "Press to Quit this XCF Xcode MCP Server".

💡 Solução de problemas: Se o XCF não exibir o alerta, execute este comando:
codesign --force --deep --sign - /Applications/xcf.app

Você também pode compilar o xcf a partir do código-fonte usando o Xcode.

Nota sobre o arquivo de código-fonte: os pacotes do aplicativo 1.0.6 anexados incluem correções de compatibilidade feitas após a tag 1.0.6. Os arquivos de código-fonte gerados automaticamente pelo GitHub para essa tag não incluem essas correções.

🔧 Configuração Rápida

Requisitos Mínimos:

macOS 13.5 ou posterior para o aplicativo empacotado.
Xcode para automação de projetos Xcode.
Um cliente MCP configurado para iniciar o XCF via entrada/saída padrão.

Adicione o xcf ao seu arquivo de configuração MCP:

{
  "mcpServers": {
    "xcf": {
      "type": "stdio",
      "command": "/Applications/xcf.app/Contents/MacOS/xcf",
      "args": ["server"]
    }
  }
}

Locais de Configuração

Cursor: ~/.cursor/mcp.json
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

⚠️ Importante: Reinicie seu assistente de IA após a configuração ou atualize a ferramenta.

⚙️ Configuração Avançada

Para clientes que não sejam Cursor ou usuários que precisam de controle estrito no nível do projeto:

{
  "mcpServers": {
    "xcf": {
      "type": "stdio",
      "command": "/Applications/xcf.app/Contents/MacOS/xcf",
      "args": ["server"],
      "env": {
          "XCODE_PROJECT_FOLDER": "/path/to/project/",
          "XCODE_PROJECT": "/path/to/project/project.xcodeproj"
      }
    }
  }
}

Essas variáveis de ambiente permitem que você:

Pré-selecione um projeto Xcode específico para trabalhar
Defina um limite de workspace personalizado para segurança

✨ Principais Recursos

Zero Dependências: Fácil de instalar, sem depender de outros servidores MCP
Detecção Automática de Projetos: Seleciona automaticamente seu projeto Xcode para que você comece a codificar imediatamente
Tratamento de Erros em Tempo Real: xcf build ou xcf run envia erros e avisos do Xcode diretamente para sua IDE de IA
Correções com IA: Deixe o Claude corrigir bugs e erros durante suas sessões de codificação
Comandos Intuitivos: Estrutura de comandos simples e amigável para desenvolvedores, visando máxima produtividade
Operações Abrangentes de Arquivos: Leia arquivos e diretórios com facilidade
Integração com Xcode: Compile, execute e gerencie projetos Xcode diretamente
Análise Avançada de Código: Obtenha análise detalhada de código Swift sem compilar no Xcode

🛠️ Perfeito para Desenvolvedores Swift

A ferramenta é projetada por desenvolvedores Swift, para desenvolvedores Swift. Comandos como build, run, show e nossas novas operações de arquivo e diretório tornam o fluxo de trabalho intuitivo e natural.

📋 Referência de Comandos

Comando xcf	Descrição da Ação
`show`	Listar projetos Xcode abertos
`open #`	Selecionar projeto por número
`run`	Executar o projeto atual
`build`	Compilar o projeto atual
`current`	Mostrar o projeto selecionado
`env`	Mostrar variáveis de ambiente
`pwd`	Mostrar a pasta atual (aliases: dir, path)
`help`	Exibir todos os comandos disponíveis

Operações de Arquivo

Comando	Descrição
`read_file <file>`	Ler conteúdo de um arquivo
`read_dir [path] [extension]`	Listar conteúdo do diretório
`cd_dir <path>`	Mudar de diretório

Ferramentas de Análise

Comando	Descrição
`snippet <file> [start] [end]`	Extrair trechos de código
`analyzer <file> [start] [end]`	Analisar código Swift
`lz <file>`	Abreviação para o analisador

📄 Usando Trechos de Código

Para Comandos Humanos

O xcf suporta comandos de trecho simplificados e fáceis de usar:

Para obter um arquivo inteiro, basta usar o nome do arquivo:

xcf snippet filename.swift

Não é necessário usar caminhos completos na maioria dos casos - o xcf encontrará e exibirá inteligentemente o conteúdo completo do arquivo.

Para intervalos de linhas específicos:

xcf snippet filename.swift 10 20

Você pode usar qualquer um dos formatos para operações de arquivo:

xcf snippet /path/to/file.swift                 // Direct path
xcf snippet filePath=/path/to/file.swift        // Named parameter

xcf analyze /path/to/file.swift                 // Direct path
xcf analyze filePath=/path/to/file.swift        // Named parameter

xcf lz /path/to/file.swift                      // Direct path (shorthand)
xcf lz filePath=/path/to/file.swift             // Named parameter (shorthand)

Para intervalos de linhas específicos:

xcf snippet /path/to/file.swift 10 20           // Direct path with line range
xcf snippet filePath=/path/to/file.swift startLine=10 endLine=20  // Named parameters

Para Assistentes de IA

Ao usar o xcf por meio das ferramentas MCP, use esta sintaxe:

mcp_xcf_snippet filePath="filename.swift" entireFile=true

Para intervalos de linhas específicos:

mcp_xcf_snippet filePath="filename.swift" startLine=10 endLine=20

Resolução Inteligente de Caminhos

Quando um arquivo não é encontrado no caminho exato, o xcf o procurará inteligentemente:

Primeiro, tenta o caminho exato fornecido
Resolve caminhos relativos usando o diretório de trabalho atual
Procura no diretório do projeto atual e um nível acima
Procura na pasta do workspace definida por WORKSPACE_FOLDER_PATHS
Procura recursivamente nas pastas do workspace com profundidade limitada
Como último recurso, realiza uma busca difusa por nomes de arquivos semelhantes

Essa resolução inteligente de caminhos é usada consistentemente em TODAS as operações de arquivo no xcf, incluindo:

Leitura de arquivos e trechos de código
Análise de código
Operações de diretório

Isso significa que você geralmente pode usar apenas o nome do arquivo, sem caminho, para qualquer operação:

xcf snippet Constants.swift    // For humans
xcf analyze Constants.swift    // For humans

Ou para assistentes de IA:

mcp_xcf_snippet filePath="Constants.swift" entireFile=true
mcp_xcf_analyzer filePath="Constants.swift" entireFile=true

🔍 Análise de Código Swift

Para Comandos Humanos

Analise um arquivo Swift inteiro em busca de problemas potenciais:

xcf analyze filename.swift

Ou use a versão abreviada:

xcf lz filename.swift

Para intervalos de linhas específicos:

xcf analyze filename.swift --startLine 10 --endLine 50

Para Assistentes de IA

Ao usar o xcf por meio das ferramentas MCP, use esta sintaxe:

mcp_xcf_analyzer filePath="filename.swift" entireFile=true

Ou use a versão abreviada:

mcp_xcf_xcf action="lz filename.swift"

Para intervalos de linhas específicos:

mcp_xcf_analyzer filePath="filename.swift" startLine=10 endLine=50

A análise identifica problemas como:

Problemas de estilo e formatação de código
Funções com alta complexidade
Variáveis e símbolos não utilizados
Números mágicos
Métodos longos
E muito mais

🧩 Ferramentas MCP (21 Ferramentas)

Ferramentas Principais

Ferramenta	Descrição
`xcf`	Executa ações do xcf (show, open, build, run, current, env, pwd, analyze, lz)
`list`	Lista todas as ferramentas disponíveis neste servidor
`xcf_help`	Ajuda rápida apenas para ações do xcf
`help`	Ajuda completa com exemplos comuns
`use_xcf`	Ativa o modo XCF
`tools`	Mostra referência detalhada de todas as ferramentas, incluindo chamadas de função de IA
`show_help`	Exibe informações de ajuda sobre os comandos disponíveis

Ferramentas de Gerenciamento de Projetos

Ferramenta	Descrição
`build_project`	Compila o projeto Xcode atual
`run_project`	Executa o projeto Xcode atual
`list_projects`	Lista todos os projetos Xcode abertos
`select_project`	Seleciona um projeto Xcode por número
`show_current_project`	Mostra informações sobre o projeto atualmente selecionado
`show_env`	Exibe todas as variáveis de ambiente
`show_folder`	Exibe a pasta de trabalho atual
`grant_permission`	Concede permissões de automação do Xcode

Ferramentas de Sistema de Arquivos

Ferramenta	Descrição
`read_file`	Lê o conteúdo de um arquivo
`read_dir`	Lista o conteúdo de um diretório
`cd_dir`	Muda o diretório atual

Ferramentas de Análise de Código

Ferramenta	Descrição
`snippet`	Extrai trechos de código de arquivos
`analyzer`	Analisa código Swift em busca de problemas potenciais
`analyze_swift_code`	Analisa código Swift com grupos de verificação personalizáveis (syntax, style, safety, performance, bestPractices)

Para Chamadas de Função de IA

Para obter um arquivo inteiro:

mcp_xcf_snippet(filePath="/full/path/to/file.swift", entireFile=true)

Para intervalos de linhas específicos:

mcp_xcf_snippet(filePath="/full/path/to/file.swift", startLine=10, endLine=20)

Para analisar um arquivo inteiro:

mcp_xcf_analyzer(filePath="/full/path/to/file.swift", entireFile=true)

Para intervalos de linhas específicos:

mcp_xcf_analyzer(filePath="/full/path/to/file.swift", startLine=10, endLine=50)

Trabalhando com Arquivos e Diretórios

Ler um arquivo:

mcp_xcf_read_file filePath="main.swift"

Listar conteúdo do diretório:

mcp_xcf_read_dir directoryPath="."

Listar apenas arquivos Swift:

mcp_xcf_read_dir directoryPath="src" fileExtension="swift"

Mudar de diretório:

mcp_xcf_cd_dir directoryPath="src"

🔒 Recursos de Segurança

Trabalha com segurança em projetos no seu workspace designado
Impede automaticamente o acesso fora dos limites do seu workspace
Redireciona para alternativas seguras quando necessário
Usa variáveis de ambiente para definir limites seguros

🔄 Exemplos de Fluxo de Trabalho

Fluxo de Trabalho Básico (Para Humanos)

xcf show - Ver projetos disponíveis
xcf open 1 - Selecionar um projeto
xcf build - Compilar o projeto
xcf run - Executar o projeto

Fluxo de Trabalho de Análise de Código (Para Humanos)

xcf current - Verificar o projeto atual
xcf snippet filename.swift - Examinar o código
xcf lz filename.swift - Analisar o código
xcf build - Compilar após corrigir problemas

Fluxo de Trabalho de Manipulação de Arquivos (Para Humanos)

read_dir . - Listar arquivos no diretório atual
read_file main.swift - Ver o conteúdo do arquivo
Use as ferramentas nativas do Agente para edição de arquivos
xcf build - Compilar após as alterações

Fluxo de Trabalho Básico (Para Assistentes de IA)

mcp_xcf_xcf action="show" - Ver projetos disponíveis
mcp_xcf_xcf action="open 1" - Selecionar um projeto
mcp_xcf_xcf action="build" - Compilar o projeto
mcp_xcf_xcf action="run" - Executar o projeto

Fluxo de Trabalho de Análise de Código (Para Assistentes de IA)

mcp_xcf_xcf action="current" - Verificar o projeto atual
mcp_xcf_snippet filePath="filename.swift" entireFile=true - Examinar o código
mcp_xcf_analyzer filePath="filename.swift" entireFile=true - Analisar o código
mcp_xcf_xcf action="build" - Compilar após corrigir problemas

Fluxo de Trabalho de Manipulação de Arquivos (Para Assistentes de IA)

mcp_xcf_read_dir directoryPath="." - Listar arquivos no diretório atual
mcp_xcf_read_file filePath="main.swift" - Ver o conteúdo do arquivo
Use a ferramenta nativa edit_file do Agente para edição de arquivos
mcp_xcf_xcf action="build" - Compilar após as alterações

📺 Demonstração

Veja o XCF em ação: Demonstração no YouTube

❓ Solução de Problemas

Se os comandos falharem, verifique:

Se a instalação do xcf está correta
Atualize o servidor MCP do xcf
Verifique se o servidor inicia e está na sua pasta /Applications
Variáveis de ambiente com env como "server"
Reinicie seu assistente de IA

🤝 Comunidade Open Source

Engenheiros Swift são bem-vindos para contribuir! Ajude-nos a tornar o xcf ainda melhor.

💯 100% Swift. 100% Open Source.

Repositório no GitHub

Criado por XCodeFreeze Automation e CodeFreeze.ai - Levando o futuro do desenvolvimento Swift para a ponta dos seus dedos!

AgentiLoop: agentiloop.ai