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

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

Instala Claude for Desktop (asegúrate de tener la última versión)
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
```

Agrega la configuración del servidor:

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

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

Modifica el código en src/
Compila con npm run build
Prueba con npm run test:requests
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

Crea una cuenta en MockAPI
Crea un nuevo proyecto
Crea un recurso llamado user con los siguientes campos:
- id (number, autogenerado)
- name (string)
- phrase (string)
Copia la URL de tu API
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