🤖 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

🛠️ Herramientas disponibles

no

El servidor expone las siguientes herramientas MCP:

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

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