Skip to main content
Glama
Phrases MCP Server
by ronniemh

πŸ€– 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-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

  1. Install Claude for Desktop (make sure you have the latest version)

  2. Configure Claude for Desktop to use this MCP server:

    Open the configuration file (MAC/Linux) at:

    ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Add server configuration:

    {
        "mcpServers": {
            "phrases": {
                "command": "node",
                "args": [
                    "/RUTA_ABSOLUTA_A/phrases/build/index.js"
                ]
            }
        }
    }
  4. 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

  1. Modify the code in src/

  2. Compile with npm run build

  3. Test with npm run test:requests

  4. 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

  1. Create an account on MockAPI

  2. Create a new project

  3. Create a resource called user with the following fields:

    • id (number, autogenerated)

    • name (string)

    • phrase (string)

  4. Copy your API URL

  5. 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

Available Tools

6 tools
create-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

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers