
mcp-prompts
Model Context Protocol server for managing, storing, and providing prompts and prompt templates for LLM interactions.
Stars: 74

mcp-prompts is a Python library that provides a collection of prompts for generating creative writing ideas. It includes a variety of prompts such as story starters, character development, plot twists, and more. The library is designed to inspire writers and help them overcome writer's block by offering unique and engaging prompts to spark creativity. With mcp-prompts, users can access a wide range of writing prompts to kickstart their imagination and enhance their storytelling skills.
README:
A robust, extensible server for managing, versioning, and serving prompts and templates for LLM applications, built on the Model Context Protocol (MCP).
- HTTP Mode - Traditional REST API server
- MCP Mode - Model Context Protocol server for AI assistants
-
add_prompt
- Add new prompts to collection -
get_prompt
- Retrieve prompts by ID -
list_prompts
- List prompts with filtering -
update_prompt
- Update existing prompts -
delete_prompt
- Remove prompts -
apply_template
- Apply variables to template prompts -
get_stats
- Get prompt statistics
- Code Review Assistant
- Documentation Writer
- Bug Analyzer
- Architecture Reviewer
- Test Case Generator
npm install @sparesparrow/mcp-prompts
# Start HTTP server
npm start
# or
MODE=http node dist/index.js
# Server runs on http://localhost:3003
# API docs: http://localhost:3003/api-docs
# Health check: http://localhost:3003/health
# Start MCP server
MODE=mcp node dist/index.js
# or
npm run start:mcp
-
Configure Cursor MCP: Add to
.cursor/mcp.json
:{ "mcpServers": { "mcp-prompts": { "command": "node", "args": ["dist/index.js"], "env": { "MODE": "mcp" } } } }
-
Restart Cursor to load the MCP server
-
Use in Cursor:
- The MCP tools will be available in Cursor's AI assistant
- You can ask Cursor to manage prompts using natural language
pnpm run docker:build:mcp
pnpm run docker:up:mcp
pnpm run docker:logs:mcp
- MCP_README.md - Comprehensive MCP usage guide
- API Documentation - Full API reference
- Examples - Usage examples and configurations
- Node.js >= 20.0.0
- pnpm >= 9.0.0
# Install dependencies
pnpm install
# Build the project
pnpm run build
# Start development server
pnpm run dev
# Build
pnpm run build
pnpm run build:clean
# Start servers
pnpm run start # Default mode
pnpm run start:http # HTTP mode
pnpm run start:mcp # MCP mode
# Docker
pnpm run docker:build:mcp
pnpm run docker:up:mcp
pnpm run docker:down:mcp
# Testing
pnpm run test
pnpm run test:watch
# Linting & Formatting
pnpm run lint
pnpm run format
mcp-prompts/
├── src/
│ ├── index.ts # Main entry point
│ ├── mcp-server.ts # MCP server implementation
│ ├── http-server.ts # HTTP server implementation
│ └── utils.ts # Utility functions
├── data/
│ └── sample-prompts.json # Pre-loaded templates
├── dist/ # Compiled output
├── docs/ # Documentation
├── examples/ # Usage examples
└── docker/ # Docker configurations
# Test MCP server functionality
node test-mcp-complete.js
# Start HTTP server
pnpm run start:http
<<<<<<< HEAD
=======
# Test endpoints
curl http://localhost:3003/health
curl http://localhost:3003/api-docs
{
"method": "tools/call",
"params": {
"name": "list_prompts",
"arguments": {}
}
}
<<<<<<< HEAD
TypeScript Path Resolution Errors:
# Clear TypeScript cache
rm -rf **/*.tsbuildinfo
pnpm run clean
pnpm run build
SWC Build Failures:
# Ensure SWC is installed
pnpm add -D @swc/cli @swc/core
# Clean and rebuild
pnpm run clean
pnpm run build
Workspace Dependency Issues:
# Reinstall workspace dependencies
pnpm install --force
pnpm run build
Missing Modules or Types:
- Ensure you have built
@mcp-prompts/core
first - Check that all
dist/
directories are up to date - If you change the shared config or move files, clean all
dist/
directories and rebuild
Common Issues:
- If you see errors about missing modules or types, ensure you have built
@mcp-prompts/core
first and that alldist/
directories are up to date. - If you change the shared config or move files, clean all
dist/
directories and rebuild.
MCP Prompts follows a clean hexagonal architecture pattern:
- Core: Pure domain logic without infrastructure dependencies
- Ports: Interfaces defined in core package
- Adapters: Infrastructure implementations in adapter packages
- Apps: Composition and configuration in apps folder
mcp-prompts/
├── packages/
│ ├── core/ # Domain logic and ports
│ ├── @sparesparrow/ # Shared packages
│ └── adapters-*/ # Port implementations
├── apps/
│ └── server/ # MCP server application
└── docs/ # Documentation
# Build entire workspace
pnpm run build
# Development with watch mode
pnpm run build:watch
# Type checking
pnpm run typecheck
# Clean build artifacts
pnpm run clean
# Core package
pnpm -F @sparesparrow/mcp-prompts-core build
pnpm -F @sparesparrow/mcp-prompts-core test
# Adapter packages
pnpm -F @sparesparrow/mcp-prompts-adapters-file build
pnpm -F @sparesparrow/mcp-prompts-adapters-mdc build
# Server app
pnpm -F apps/server build
pnpm -F apps/server test
- Vitest for unit tests
- Playwright for e2e tests
- Coverage > 90% for core packages
- Integration tests for adapters
For detailed API documentation, see:
- Turborepo TypeScript Monorepo Guide
- Separate tsconfig for builds
- Hexagonal Architecture: Wikipedia
- MCP Specification =======
{
"method": "tools/call",
"params": {
"name": "apply_template",
"arguments": {
"id": "code_review_assistant",
"variables": {
"language": "JavaScript",
"code": "function hello() { console.log('Hello World'); }"
}
}
}
}
{
"method": "tools/call",
"params": {
"name": "add_prompt",
"arguments": {
"name": "My Custom Prompt",
"content": "This is a custom prompt for {{subject}}",
"isTemplate": true,
"tags": ["custom", "example"],
"variables": [
{
"name": "subject",
"description": "The subject to process",
"required": true,
"type": "string"
}
]
}
}
}
-
Template Variables - Use
{{variable}}
syntax for dynamic content - Tag System - Organize prompts with tags for easy filtering
- Metadata Support - Add categories, difficulty, time estimates
- Version Control - Track prompt versions and changes
- Error Handling - Comprehensive error handling and logging
- TypeScript - Full TypeScript support with type definitions
- Docker Ready - Containerized deployment support
- Fork the repository
- Create a feature branch
- Implement your changes
- Add tests if applicable
- Submit a pull request
MIT License - see LICENSE file for details.
- Issues: GitHub Issues
- Documentation: MCP_README.md
- Examples: examples/
Version: 3.0.8
Status: ✅ Production Ready
MCP Support: ✅ Full Implementation
Cursor Integration: ✅ Ready
For Tasks:
Click tags to check more tools for each tasksFor Jobs:
Alternative AI tools for mcp-prompts
Similar Open Source Tools

mcp-prompts
mcp-prompts is a Python library that provides a collection of prompts for generating creative writing ideas. It includes a variety of prompts such as story starters, character development, plot twists, and more. The library is designed to inspire writers and help them overcome writer's block by offering unique and engaging prompts to spark creativity. With mcp-prompts, users can access a wide range of writing prompts to kickstart their imagination and enhance their storytelling skills.

Jailbreaks
Jailbreaks is a repository dedicated to organizing and curating models suitable for NSFW writing. It serves as a collection of resources for writers looking to explore adult content in a structured manner.

GenAiGuidebook
GenAiGuidebook is a comprehensive resource for individuals looking to begin their journey in GenAI. It serves as a detailed guide providing insights, tips, and information on various aspects of GenAI technology. The guidebook covers a wide range of topics, including introductory concepts, practical applications, and best practices in the field of GenAI. Whether you are a beginner or an experienced professional, this resource aims to enhance your understanding and proficiency in GenAI.

bravegpt
BraveGPT is a userscript that brings the power of ChatGPT to Brave Search. It allows users to engage with a conversational AI assistant directly within their search results, providing instant and personalized responses to their queries. BraveGPT is powered by GPT-4, the latest and most advanced language model from OpenAI, ensuring accurate and comprehensive answers. With BraveGPT, users can ask questions, get summaries, generate creative content, and more, all without leaving the Brave Search interface. The tool is easy to install and use, making it accessible to users of all levels. BraveGPT is a valuable addition to the Brave Search experience, enhancing its capabilities and providing users with a more efficient and informative search experience.

SillyTavern
SillyTavern is a user interface you can install on your computer (and Android phones) that allows you to interact with text generation AIs and chat/roleplay with characters you or the community create. SillyTavern is a fork of TavernAI 1.2.8 which is under more active development and has added many major features. At this point, they can be thought of as completely independent programs.

MarkFlowy
MarkFlowy is a lightweight and feature-rich Markdown editor with built-in AI capabilities. It supports one-click export of conversations, translation of articles, and obtaining article abstracts. Users can leverage large AI models like DeepSeek and Chatgpt as intelligent assistants. The editor provides high availability with multiple editing modes and custom themes. Available for Linux, macOS, and Windows, MarkFlowy aims to offer an efficient, beautiful, and data-safe Markdown editing experience for users.

AlphaAvatar
AlphaAvatar is a powerful tool for creating customizable avatars with AI-generated faces. It provides a user-friendly interface to design unique characters for various purposes such as gaming, virtual reality, social media, and more. With advanced AI algorithms, users can easily generate realistic and diverse avatars to enhance their projects and engage with their audience.

lite.koboldai.net
KoboldAI Lite is a standalone Web UI that serves as a text editor designed for use with generative LLMs. It is compatible with KoboldAI United and KoboldAI Client, bundled with KoboldCPP, and integrates with the AI Horde for text and image generation. The UI offers multiple modes for different writing styles, supports various file formats, includes premade scenarios, and allows easy sharing of stories. Users can enjoy features such as memory, undo/redo, text-to-speech, and a range of samplers and configurations. The tool is mobile-friendly and can be used directly from a browser without any setup or installation.

Memento
Memento is a lightweight and user-friendly version control tool designed for small to medium-sized projects. It provides a simple and intuitive interface for managing project versions and collaborating with team members. With Memento, users can easily track changes, revert to previous versions, and merge different branches. The tool is suitable for developers, designers, content creators, and other professionals who need a streamlined version control solution. Memento simplifies the process of managing project history and ensures that team members are always working on the latest version of the project.

deeppowers
Deeppowers is a powerful Python library for deep learning applications. It provides a wide range of tools and utilities to simplify the process of building and training deep neural networks. With Deeppowers, users can easily create complex neural network architectures, perform efficient training and optimization, and deploy models for various tasks. The library is designed to be user-friendly and flexible, making it suitable for both beginners and experienced deep learning practitioners.

sciml.ai
SciML.ai is an open source software organization dedicated to unifying packages for scientific machine learning. It focuses on developing modular scientific simulation support software, including differential equation solvers, inverse problems methodologies, and automated model discovery. The organization aims to provide a diverse set of tools with a common interface, creating a modular, easily-extendable, and highly performant ecosystem for scientific simulations. The website serves as a platform to showcase SciML organization's packages and share news within the ecosystem. Pull requests are encouraged for contributions.

dspy.rb
DSPy.rb is a Ruby framework for building reliable LLM applications using composable, type-safe modules. It enables developers to define typed signatures and compose them into pipelines, offering a more structured approach compared to traditional prompting. The framework embraces Ruby conventions and adds innovations like CodeAct agents and enhanced production instrumentation, resulting in scalable LLM applications that are robust and efficient. DSPy.rb is actively developed, with a focus on stability and real-world feedback through the 0.x series before reaching a stable v1.0 API.

ito
Ito is an intelligent voice assistant that provides seamless voice dictation to any application on your computer. It works in any app, offers global keyboard shortcuts, real-time transcription, and instant text insertion. It is smart and adaptive with features like custom dictionary, context awareness, multi-language support, and intelligent punctuation. Users can customize trigger keys, audio preferences, and privacy controls. It also offers data management features like a notes system, interaction history, cloud sync, and export capabilities. Ito is built as a modern Electron application with a multi-process architecture and utilizes technologies like React, TypeScript, Rust, gRPC, and AWS CDK.

trustgraph
TrustGraph is a tool that deploys private GraphRAG pipelines to build a RDF style knowledge graph from data, enabling accurate and secure `RAG` requests compatible with cloud LLMs and open-source SLMs. It showcases the reliability and efficiencies of GraphRAG algorithms, capturing contextual language flags missed in conventional RAG approaches. The tool offers features like PDF decoding, text chunking, inference of various LMs, RDF-aligned Knowledge Graph extraction, and more. TrustGraph is designed to be modular, supporting multiple Language Models and environments, with a plug'n'play architecture for easy customization.

chainlit
Chainlit is an open-source async Python framework which allows developers to build scalable Conversational AI or agentic applications. It enables users to create ChatGPT-like applications, embedded chatbots, custom frontends, and API endpoints. The framework provides features such as multi-modal chats, chain of thought visualization, data persistence, human feedback, and an in-context prompt playground. Chainlit is compatible with various Python programs and libraries, including LangChain, Llama Index, Autogen, OpenAI Assistant, and Haystack. It offers a range of examples and a cookbook to showcase its capabilities and inspire users. Chainlit welcomes contributions and is licensed under the Apache 2.0 license.

chatmcp
Chatmcp is a chatbot framework for building conversational AI applications. It provides a flexible and extensible platform for creating chatbots that can interact with users in a natural language. With Chatmcp, developers can easily integrate chatbot functionality into their applications, enabling users to communicate with the system through text-based conversations. The framework supports various natural language processing techniques and allows for the customization of chatbot behavior and responses. Chatmcp simplifies the development of chatbots by providing a set of pre-built components and tools that streamline the creation process. Whether you are building a customer support chatbot, a virtual assistant, or a chat-based game, Chatmcp offers the necessary features and capabilities to bring your conversational AI ideas to life.
For similar tasks

AI_NovelGenerator
AI_NovelGenerator is a versatile novel generation tool based on large language models. It features a novel setting workshop for world-building, character development, and plot blueprinting, intelligent chapter generation for coherent storytelling, a status tracking system for character arcs and foreshadowing management, a semantic retrieval engine for maintaining long-range context consistency, integration with knowledge bases for local document references, an automatic proofreading mechanism for detecting plot contradictions and logic conflicts, and a visual workspace for GUI operations encompassing configuration, generation, and proofreading. The tool aims to assist users in efficiently creating logically rigorous and thematically consistent long-form stories.

mcp-prompts
mcp-prompts is a Python library that provides a collection of prompts for generating creative writing ideas. It includes a variety of prompts such as story starters, character development, plot twists, and more. The library is designed to inspire writers and help them overcome writer's block by offering unique and engaging prompts to spark creativity. With mcp-prompts, users can access a wide range of writing prompts to kickstart their imagination and enhance their storytelling skills.

Jailbreaks
Jailbreaks is a repository dedicated to organizing and curating models suitable for NSFW writing. It serves as a collection of resources for writers looking to explore adult content in a structured manner.

AgentVerse
AgentVerse is an open-source ecosystem for intelligent agents, supporting multiple mainstream AI models to facilitate autonomous discussions, thought collisions, and knowledge exploration. Each intelligent agent can play a unique role here, collectively creating wisdom beyond individuals.
For similar jobs

LLMStack
LLMStack is a no-code platform for building generative AI agents, workflows, and chatbots. It allows users to connect their own data, internal tools, and GPT-powered models without any coding experience. LLMStack can be deployed to the cloud or on-premise and can be accessed via HTTP API or triggered from Slack or Discord.

daily-poetry-image
Daily Chinese ancient poetry and AI-generated images powered by Bing DALL-E-3. GitHub Action triggers the process automatically. Poetry is provided by Today's Poem API. The website is built with Astro.

exif-photo-blog
EXIF Photo Blog is a full-stack photo blog application built with Next.js, Vercel, and Postgres. It features built-in authentication, photo upload with EXIF extraction, photo organization by tag, infinite scroll, light/dark mode, automatic OG image generation, a CMD-K menu with photo search, experimental support for AI-generated descriptions, and support for Fujifilm simulations. The application is easy to deploy to Vercel with just a few clicks and can be customized with a variety of environment variables.

SillyTavern
SillyTavern is a user interface you can install on your computer (and Android phones) that allows you to interact with text generation AIs and chat/roleplay with characters you or the community create. SillyTavern is a fork of TavernAI 1.2.8 which is under more active development and has added many major features. At this point, they can be thought of as completely independent programs.

Twitter-Insight-LLM
This project enables you to fetch liked tweets from Twitter (using Selenium), save it to JSON and Excel files, and perform initial data analysis and image captions. This is part of the initial steps for a larger personal project involving Large Language Models (LLMs).

AISuperDomain
Aila Desktop Application is a powerful tool that integrates multiple leading AI models into a single desktop application. It allows users to interact with various AI models simultaneously, providing diverse responses and insights to their inquiries. With its user-friendly interface and customizable features, Aila empowers users to engage with AI seamlessly and efficiently. Whether you're a researcher, student, or professional, Aila can enhance your AI interactions and streamline your workflow.

ChatGPT-On-CS
This project is an intelligent dialogue customer service tool based on a large model, which supports access to platforms such as WeChat, Qianniu, Bilibili, Douyin Enterprise, Douyin, Doudian, Weibo chat, Xiaohongshu professional account operation, Xiaohongshu, Zhihu, etc. You can choose GPT3.5/GPT4.0/ Lazy Treasure Box (more platforms will be supported in the future), which can process text, voice and pictures, and access external resources such as operating systems and the Internet through plug-ins, and support enterprise AI applications customized based on their own knowledge base.

obs-localvocal
LocalVocal is a live-streaming AI assistant plugin for OBS that allows you to transcribe audio speech into text and perform various language processing functions on the text using AI / LLMs (Large Language Models). It's privacy-first, with all data staying on your machine, and requires no GPU, cloud costs, network, or downtime.