🤖 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:

🚀 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