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