Phrases MCP Server
The Phrases MCP Server is a tool for managing inspirational phrases, accessible via MCP clients like Claude for Desktop. It offers these capabilities:
Get all phrases - Retrieve a list of all available phrases
Get phrase by ID - Fetch a specific phrase using its unique ID
Get phrase by author name - Search for phrases by author
Create a new phrase - Add new phrases with author and text
Update a phrase - Modify existing phrase text using its ID
Delete a phrase - Remove phrases by ID
The server integrates with Claude for Desktop and utilizes a mock API for data storage (a real database is recommended for production).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Phrases MCP Server show me all inspirational phrases by Maya Angelou"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π€ 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
Related MCP server: PoetryQuill Analytics MCP
π οΈ Available tools
The server exposes the following MCP tools:
Tool | Description |
| Get all available phrases |
| Search for a phrase by its ID |
| Search for phrases by author name |
| Create a new sentence |
| Updates the text of an existing sentence |
| 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.jsonAdd 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:requestsThis 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 buildTest with
npm run test:requestsRestart 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/userSetting up your own MockAPI instance
Create an account on MockAPI
Create a new project
Create a resource called
userwith the following fields:id(number, autogenerated)name(string)phrase(string)
Copy your API URL
Update the
BASE_URLconstant in thesrc/helpers/makeMockAPIRequest.tsfile
// 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
Available Tools
6 toolscreate-phraseC
Creates a new phrase for an author.
Inputs: name (required), phrase (required).
delete-phraseC
Deletes a phrase by its ID.
Inputs: id (required).
get-all-phrasesC
Returns a list of all phrases.
Inputs: no named parameters.
get-phrase-by-idC
Returns a phrase by its ID.
Inputs: id (required).
get-phrase-by-nameC
Returns a phrase by author name.
Inputs: name (required).
update-phraseC
Updates the text of a phrase by its ID.
Inputs: id (required), phrase (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Each tool has a distinct purpose with no overlap: create, delete, get all, get by ID, get by name, and update. The descriptions clearly differentiate between operations on phrases by ID, name, or all phrases, eliminating any ambiguity.
All tool names follow a consistent verb_noun pattern (e.g., create-phrase, delete-phrase, get-all-phrases). The naming is uniform across all six tools, using hyphens to separate words and clear action verbs.
With 6 tools, this server is well-scoped for managing phrases, covering essential CRUD operations and additional retrieval methods. The count is appropriate, providing comprehensive functionality without being excessive or insufficient.
The tool set offers complete CRUD coverage (create, read, update, delete) and includes multiple read options (all, by ID, by name). There are no obvious gaps; agents can perform all expected lifecycle operations for phrase management.
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP Server for the Notion API, enabling Claude to interact with Notion workspaces.313,089 npm925MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that connects Claude Desktop to PoetryQuill's live Supabase database. Ask Claude natural language questions about your platform data.-
- AlicenseBqualityDmaintenanceAn MCP server that enables Claude to interact with Google Sheets via the SheetsDB API, supporting CRUD operations and smart data addition.6MIT
- FlicenseNot gradedqualityDmaintenanceA simple MCP server in Python, configurable via environment variables and database, designed for integration with Claude Desktop.-