🤖 Phrases MCP Server

Un servidor MCP (Model Context Protocol) elegante y eficiente para gestionar frases inspiradoras. Diseñado para integrarse perfectamente con Claude for Desktop y otros clientes MCP.

✨ Características

• Gestión completa de frases - Crea, lee, actualiza y elimina frases con facilidad

• Integración con Claude for Desktop - Interactúa con tus frases directamente desde Claude

• API Mock integrada - Utiliza una API mock para pruebas y desarrollo

Related MCP server: ClaudeKeep

🛠️ Herramientas disponibles

no El servidor expone las siguientes herramientas MCP:

🚀 Instalación

🔌 Configuración con Claude for Desktop

1. Instala Claude for Desktop (asegúrate de tener la última versión)

2. Configura Claude for Desktop para usar este servidor MCP:

   Abre el archivo (MAC/Linux) de configuración en:

   ~/Library/Application Support/Claude/claude_desktop_config.json

3. Agrega la configuración del servidor:

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

4. Reinicia Claude for Desktop

💡 Uso con Claude

Una vez configurado, puedes interactuar con tus frases directamente desde Claude for Desktop:

• "Muéstrame todas las frases disponibles"

• "Busca frases de [nombre de autor]"

• "Crea una nueva frase para [nombre] que diga [texto]"

• "Actualiza la frase con ID [número] a [nuevo texto]"

• "Elimina la frase con ID [número]"

🧪 Pruebas

⚠️ Importante: Configuración para pruebas

Antes de ejecutar las pruebas, debes modificar temporalmente el archivo tsconfig.json. Cambia la sección compilerOptions a:

Nota: No olvides volver a la configuración original después de las pruebas para que la compilación del servidor MCP funcione correctamente.

Para ejecutar las pruebas:

Este comando ejecutará una serie de pruebas que crean, leen, actualizan y eliminan frases utilizando la API mock.

🏗️ Estructura del proyecto

🔄 Flujo de trabajo de desarrollo

1. Modifica el código en src/

2. Compila con npm run build

3. Prueba con npm run test:requests

4. Reinicia Claude for Desktop para aplicar los cambios

🔍 Configuración de MockAPI

Este proyecto utiliza MockAPI como backend para almacenar y gestionar las frases. La URL base configurada es:

Configurar tu propia instancia de MockAPI

1. Crea una cuenta en MockAPI

2. Crea un nuevo proyecto

3. Crea un recurso llamado user con los siguientes campos:

   • id (number, autogenerado)

   • name (string)

   • phrase (string)

4. Copia la URL de tu API

5. Actualiza la constante BASE_URL en el archivo src/helpers/makeMockAPIRequest.ts

📝 Notas adicionales

• Este servidor utiliza una API mock para almacenar datos. En un entorno de producción, considera implementar una base de datos real.

• La estructura del proyecto sigue las directrices oficiales de MCP para una mejor mantenibilidad.

• Si encuentras problemas con la API mock, verifica los límites de uso gratuito de MockAPI.

📄 Licencia

ISC