Phrases MCP Server

🤖 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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

An elegant MCP server that lets users manage inspirational phrases directly through Claude for Desktop, offering complete CRUD operations for phrases with author attribution.

Related MCP Servers

Salesforce MCP Server
tsmztech
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
87
15
TypeScript
MIT License
Salesforce MCP Server
SurajAdsul
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
18
4
TypeScript
MIT License
Image-Gen-Server
fengin
-
security
A
license
-
quality
A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.
Last updated -
82
Python
MIT License
Zanny's Persistent Memory Manager
zannyonear1h1
-
security
F
license
-
quality
A custom MCP server that allows storage, retrieval, and management of text-based information with natural language commands and keyword detection.
Last updated -
TypeScript

View all related MCP servers

Phrases MCP Server