Phrases MCP Server

Um servidor MCP para gerenciar frases inspiradoras, projetado para integração com clientes como o Claude for Desktop.

Documentação

🤖 Phrases MCP Server

Um servidor MCP (Model Context Protocol) elegante e eficiente para gerenciar frases inspiradoras. Projetado para integrar-se perfeitamente com o Claude for Desktop e outros clientes MCP.

✨ Características

Gerenciamento completo de frases - Cria, lê, atualiza e exclui frases com facilidade
Integração com Claude for Desktop - Interaja com suas frases diretamente pelo Claude
API mock integrada - Utilize uma API mock para testes e desenvolvimento

🛠️ Ferramentas disponíveis

O servidor expõe as seguintes ferramentas MCP:

Ferramenta	Descrição
`get-all-phrases`	Obtém todas as frases disponíveis
`get-phrase-by-id`	Busca uma frase pelo ID
`get-phrase-by-name`	Busca frases pelo nome do autor
`create-phrase`	Cria uma nova frase
`update-phrase`	Atualiza o texto de uma frase existente
`delete-phrase`	Exclui uma frase pelo ID

🚀 Instalação

# Clonar el repositorio
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

🔌 Configuração com Claude for Desktop

Instale o Claude for Desktop (certifique-se de ter a versão mais recente)
Configure o Claude for Desktop para usar este servidor MCP:

Abra o arquivo de configuração (MAC/Linux) em:
```
~/Library/Application Support/Claude/claude_desktop_config.json
```

Adicione a configuração do servidor:

{
    "mcpServers": {
        "phrases": {
            "command": "node",
            "args": [
                "/RUTA_ABSOLUTA_A/phrases/build/index.js"
            ]
        }
    }
}

Reinicie o Claude for Desktop

💡 Uso com Claude

Uma vez configurado, você pode interagir com suas frases diretamente pelo Claude for Desktop:

"Mostre-me todas as frases disponíveis"
"Busque frases de [nome do autor]"
"Crie uma nova frase para [nome] que diga [texto]"
"Atualize a frase com ID [número] para [novo texto]"
"Exclua a frase com ID [número]"

🧪 Testes

⚠️ Importante: Configuração para testes

Antes de executar os testes, você deve modificar temporariamente o arquivo tsconfig.json. Altere a seção compilerOptions para:

"compilerOptions": {
  "target": "ES2020",
  "module": "NodeNext",
  "moduleResolution": "NodeNext",
  "esModuleInterop": true,
  "outDir": "build",
  "strict": true
}

Nota: Não se esqueça de voltar à configuração original após os testes para que a compilação do servidor MCP funcione corretamente.

Para executar os testes:

npm run test:requests

Este comando executará uma série de testes que criam, leem, atualizam e excluem frases utilizando a API mock.

🏗️ Estrutura do projeto

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # Funciones de ayuda para interactuar con la API
├── index.ts                   # Punto de entrada principal y definición de herramientas
└── testRequest.ts             # Script para probar las funciones de la API

🔄 Fluxo de trabalho de desenvolvimento

Modifique o código em src/
Compile com npm run build
Teste com npm run test:requests
Reinicie o Claude for Desktop para aplicar as alterações

🔍 Configuração do MockAPI

Este projeto utiliza MockAPI como backend para armazenar e gerenciar as frases. A URL base configurada é:

https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user

Configurar sua própria instância do MockAPI

Crie uma conta no MockAPI
Crie um novo projeto
Crie um recurso chamado user com os seguintes campos:
- id (number, autogerado)
- name (string)
- phrase (string)
Copie a URL da sua API
Atualize a constante BASE_URL no arquivo src/helpers/makeMockAPIRequest.ts

// Cambia esta línea con tu propia URL de MockAPI
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 Notas adicionais

Este servidor utiliza uma API mock para armazenar dados. Em um ambiente de produção, considere implementar um banco de dados real.
A estrutura do projeto segue as diretrizes oficiais do MCP para melhor manutenibilidade.
Se encontrar problemas com a API mock, verifique os limites de uso gratuito do MockAPI.

📄 Licença

ISC