🤖 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.

<div align="center"> <img src="https://github.com/ronniemh/phrases-MCP-server/raw/main/assets/diagram.png" alt="Diagrama de arquitectura" width="600"> </div>

✨ 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

🛠️ Herramientas disponibles

no El servidor expone las siguientes herramientas MCP:

Herramienta	Descripción
get-all-phrases	Obtiene todas las frases disponibles
get-phrase-by-id	Busca una frase por su ID
get-phrase-by-name	Busca frases por nombre de autor
create-phrase	Crea una nueva frase
update-phrase	Actualiza el texto de una frase existente
delete-phrase	Elimina una frase por su ID

🚀 Instalación

# 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

🔌 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:

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

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:

npm run test:requests

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

🏗️ Estructura del proyecto

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

🔄 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:

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

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

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

📝 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