🤖 Phrases MCP Server

An elegant and efficient MCP (Model Context Protocol) server for managing inspirational quotes. Designed to integrate seamlessly with Claude for Desktop and other MCP clients.

✨ Features

Complete phrase management - Create, read, update and delete phrases with ease
Claude for Desktop Integration - Interact with your phrases directly from Claude
Integrated Mock API - Use a mock API for testing and development

🛠️ Available tools

The server exposes the following MCP tools:

Tool	Description
`get-all-phrases`	Get all available phrases
`get-phrase-by-id`	Search for a phrase by its ID
`get-phrase-by-name`	Search for phrases by author name
`create-phrase`	Create a new sentence
`update-phrase`	Updates the text of an existing sentence
`delete-phrase`	Delete a phrase by its ID

🚀 Installation

# 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

🔌 Setup with Claude for Desktop

Install Claude for Desktop (make sure you have the latest version)
Configure Claude for Desktop to use this MCP server:Open the configuration file (MAC/Linux) at:
~/Library/Application Support/Claude/claude_desktop_config.json
Add server configuration:
{ "mcpServers": { "phrases": { "command": "node", "args": [ "/RUTA_ABSOLUTA_A/phrases/build/index.js" ] } } }
Restart Claude for Desktop

💡 Use with Claude

Once configured, you can interact with your phrases directly from Claude for Desktop:

"Show me all available phrases"
"Find quotes by [author name]"
"Create a new sentence for [name] that says [text]"
"Update the phrase with ID [number] to [new text]"
"Delete the phrase with ID [number]"

🧪 Tests

⚠️ Important: Testing Settings

Before running the tests, you should temporarily modify the tsconfig.json file. Change the compilerOptions section to:

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

Note : Don't forget to revert back to the original configuration after testing to make the MCP server build work properly.

To run the tests:

npm run test:requests

This command will run a series of tests that create, read, update, and delete sentences using the mock API.

🏗️ Project structure

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

🔄 Development workflow

Modify the code in src/
Compile with npm run build
Test with npm run test:requests
Restart Claude for Desktop to apply the changes

🔍 MockAPI Configuration

This project uses MockAPI as the backend to store and manage phrases. The configured base URL is:

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

Setting up your own MockAPI instance

Create an account on MockAPI
Create a new project
Create a resource called user with the following fields:
- id (number, autogenerated)
- name (string)
- phrase (string)
Copy your API URL
Update the BASE_URL constant in the src/helpers/makeMockAPIRequest.ts file

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

📝 Additional notes

This server uses a mock API to store data. In a production environment, consider implementing a real database.
The project structure follows official MCP guidelines for better maintainability.
If you encounter issues with the Mock API, please check the MockAPI free usage limits.

📄 License

ISC