🤖 Phrases MCP Server

by ronniemh

2 122 downloads Not rated yet

About

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.

Explore

- Full CRUD operations for inspirational phrases
- Seamless integration with Claude for Desktop
- Built-in mock API for development and testing
- Exposes six MCP tools for phrase management
- Uses MockAPI as a cloud-based data store

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

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.

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

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";

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">
Diagrama de arquitectura
</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

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.