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).
🤖 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
🛠️ 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
🔌 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:
- Add server configuration:
- 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
- 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:
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 thesrc/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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
An elegant MCP server that lets users manage inspirational phrases directly through Claude for Desktop, offering complete CRUD operations for phrases with author attribution.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -718045TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.Last updated -26TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -7184TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.Last updated -Python