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

🛠️ Available tools

The server exposes the following MCP tools:

🚀 Installation

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

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:

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

🏗️ Project structure

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

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

📝 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