Phrases MCP Server

🤖 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

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