TextEdit-MCP

Um servidor Model Context Protocol (MCP) que permite ao Claude Desktop criar documentos RTF lindamente formatados com compatibilidade nativa com o TextEdit do macOS.

Início rápido

macOS, Swift 5.9 ou posterior, e um cliente MCP.

1. Clone o repositório:

git clone https://github.com/M-Pineapple/TextEdit-MCP.git
cd TextEdit-MCP

2. Execute o instalador:

./install.sh

3. Reinicie seu cliente MCP e peça um RTF formatado na sua Área de Trabalho.

Recursos

• 📝 Formatação de Texto Rico

  • Negrito, itálico, sublinhado, tachado
  • Títulos (H1-H2)
  • Formatação de parágrafos com espaçamento personalizável

• 🎨 Cores e Realce

  • Cores de texto: Vermelho, Azul, Verde
  • Cores de realce: Amarelo, Ciano, Verde, Laranja
  • Suporte completo a cores em tabelas

• 📊 Tabelas

  • Tabelas RTF reais com bordas
  • Estilo de linha de cabeçalho
  • Suporte completo a formatação dentro das células
  • Preenchimento e alinhamento automáticos de células

• 🔗 Hiperlinks

  • URLs clicáveis
  • Texto de link formatado
  • Funciona no TextEdit, Pages e Word

• 📋 Listas

  • Marcadores
  • Listas numeradas
  • Recuo adequado

• 🎯 Modelos

  • Comercial (padrão)
  • Técnico (monoespaçado)
  • Reunião (espaçamento de linha aumentado)

• 🛡️ Proteção de caminho

  • Apenas arquivos .rtf novos, dentro da pasta pessoal
  • Caminhos ocultos, sobrescritas e symlinks que resolvem fora da pasta pessoal são recusados

Instalação

Pré-requisitos

• macOS (necessário para NSAttributedString e geração de RTF)
• Swift 5.0 ou posterior
• Claude Desktop

O instalador irá:

• Compilar o projeto Swift
• Instalar o binário do servidor MCP
• Atualizar sua configuração do Claude Desktop
• Criar um backup da sua configuração existente

Veja Início rápido para os três comandos.

Uso

No Claude Desktop, você pode criar documentos RTF usando linguagem natural:

"Create an RTF document with my meeting notes"
"Make a formatted report with tables and highlights"
"Generate a technical document with code examples"

Ou use a ferramenta diretamente:

Use textedit:create_rtf_document to create a document at ~/Desktop/MyDoc.rtf

Sintaxe de Formatação

O TextEdit MCP usa uma sintaxe intuitiva semelhante a Markdown:

Formatação de Texto

• **Bold text**
• *Italic text*
• ***Bold italic text***
• ~~Strikethrough text~~

Cores

• {red}Red text{/red}
• {blue}Blue text{/blue}
• {green}Green text{/green}

Realce

• ==Yellow highlight==
• [[Cyan highlight]]
• {{Green highlight}}
• ((Orange highlight))

Títulos

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Listas

• Bullet point (or use - )
1. Numbered item
2. Another item

Tabelas

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1   | Data 2   | Data 3   |
| More     | Data     | Here     |

Links

[Link text](https://example.com)

Exemplos

Documento Simples

# Meeting Notes

## Agenda
- Review **Q4 results**
- Discuss {red}urgent issues{/red}
- Plan for next quarter

## Action Items
1. ==Update documentation==
2. [[Review code changes]]
3. Schedule follow-up

Tabela com Formatação

| Task | Status | Owner |
|------|--------|-------|
| **Documentation** | {green}✅ Complete{/green} | Team A |
| *Testing* | ==In Progress== | Team B |
| Deployment | {red}Blocked{/red} | DevOps |

Desenvolvimento

Compilando a partir do Código-Fonte

swift build -c release

Executando Testes

swift test

Estrutura do Projeto

TextEdit-MCP/
├── Sources/
│   └── TextEditMCP/
│       ├── main.swift           # Entry point
│       ├── MCPServer.swift      # MCP protocol handler
│       ├── RTFDocumentService.swift  # RTF generation
│       └── MCPLogger.swift      # Logging utility
├── docs/
│   ├── demo.gif                 # Simulated README demo
│   └── generate-demo-gif.py     # Regenerates the demo GIF
├── Package.swift
├── README.md
├── FORMATTING_GUIDE.md
└── install.sh

Como Funciona

1. Protocolo MCP: Implementa o Model Context Protocol para se comunicar com o Claude Desktop
2. NSAttributedString: Usa APIs nativas do macOS para formatação de texto rico
3. NSTextTable: Cria tabelas RTF reais com bordas e formatação de células adequadas
4. Exportação RTF: Gera arquivos RTF padrão compatíveis com TextEdit, Pages e Word

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Diretrizes

1. Mantenha a compatibilidade com o TextEdit do macOS
2. Siga as convenções de nomenclatura do Swift
3. Adicione testes para novos recursos
4. Atualize a documentação

Suporte

Se isso economizar seu tempo, uma estrela ajuda outras pessoas a encontrar.

Se você achar esta ferramenta útil, considere apoiar o desenvolvimento:

Mais servidores MCP da M-Pineapple

Outros servidores MCP neste portfólio:

• Claude Project Coordinator. Acompanhe projetos Xcode, status, stack de tecnologia e saúde.
• CryptoAnalysisMCP. Análise técnica de criptomoedas para Claude Desktop.
• Warp Command Runner. Dê a qualquer IA de chat um terminal real.
• Msty Admin MCP. Administre o Msty Studio Desktop.
• Member Berries. Apple Calendar, Notes e Reminders com personalidade.
• SeaShell. Fale com Claude de qualquer bloco de terminal.
• HubSpot Auditor. Auditoria de portal HubSpot somente leitura.

Licença

Licença MIT. Veja LICENSE para detalhes.

Agradecimentos

• Criado para uso com Claude Desktop
• Construído com Swift e AppKit
• Usa Model Context Protocol (MCP)

---

Criado por Pineapple 🍍