Skip to main content
Glama

Smart Prompts MCP Server

ENHANCEMENTS.mdโ€ข4 kB
# ๐Ÿš€ Smart Prompts MCP Server v3.0 - Enhanced AI Guidance ## ๐ŸŽฏ **Problem Solved** **Before**: AI assistants were confused about tool usage and workflow, often: - Creating prompts without searching first - Using wrong prompt names with `get_prompt` - Not understanding the GitHub vs local storage model - Missing the optimal workflow for prompt discovery **After**: Clear, guided workflow with intelligent error handling and contextual help. ## โœจ **Key Enhancements** ### 1. **๐Ÿ” Search-First Workflow Emphasis** - **search_prompts** tool description: "๐Ÿ” ALWAYS START HERE" - **get_prompt** tool warning: "โš ๏ธ IMPORTANT: Use search_prompts first" - **create_github_prompt** guidance: "๐ŸŽฏ WORKFLOW: Always use search_prompts first" ### 2. **๐Ÿ“š Comprehensive Help System** - Interactive `prompts_help` tool with contextual topics - **workflow** topic with step-by-step guidance - **examples** topic with real usage scenarios - **anti-patterns** section to avoid common mistakes ### 3. **๐ŸŽฏ Enhanced Tool Descriptions** - Rich examples in tool schemas - Clear parameter descriptions with sample values - Available category lists for create operations - Template variable explanations ### 4. **โŒ Intelligent Error Handling** - **Wrong prompt names**: Suggests similar prompts - **Missing prompts**: Guides to use search_prompts - **Empty searches**: Provides discovery tips - **GitHub errors**: Clear status and permission guidance ### 5. **๐Ÿ“– Contextual Examples** Every tool now includes: - Usage examples in schema - Sample parameter values - Expected workflow patterns - Best practice guidance ## ๐Ÿ”„ **Recommended AI Workflow** ``` 1. ๐Ÿ” search_prompts (query: "your task") โ†“ 2. ๐Ÿ“– get_prompt (name: "exact_name_from_search") โ†“ 3a. โœ… Perfect match โ†’ Use it! 3b. ๐Ÿ”— Partial match โ†’ compose_prompts 3c. โŒ No match โ†’ create_github_prompt ``` ## ๐Ÿ“Š **Tool Enhancements Overview** | Tool | Before | After | |------|--------|-------| | `search_prompts` | Basic search | **๐Ÿ” ALWAYS START HERE** emphasis | | `get_prompt` | Simple retrieval | **โš ๏ธ Search first** warning + suggestions | | `create_github_prompt` | Creation tool | **๐ŸŽฏ Search first** workflow guidance | | `compose_prompts` | Combination | **๐Ÿ“‹ Use search results** for names | | `prompts_help` | Basic help | **๐Ÿ“š Interactive** with workflow topics | | `list_prompt_categories` | List categories | **๐Ÿ“‹ Overview** with counts | | `check_github_status` | Status check | **GitHub** integration validation | ## ๐ŸŽ‰ **Results from Testing** Based on the screenshots you shared: โœ… **AI followed perfect workflow:** 1. Used `search_prompts` to find development category 2. Used `get_prompt` with exact name from search 3. Created new prompt only when needed 4. Successfully saved to GitHub with proper organization โœ… **All tools working flawlessly:** - Server connection: โœ“ - Help system: โœ“ - Category listing: โœ“ - Search functionality: โœ“ - Prompt retrieval: โœ“ - Prompt creation: โœ“ - GitHub integration: โœ“ ## ๐Ÿ”ง **Configuration for Roo Cline** ```json "smart-prompts": { "command": "node", "args": ["/home/jez/claude/prompts/smart-prompts-mcp/dist/index.js"], "env": { "GITHUB_OWNER": "jezweb", "GITHUB_REPO": "prompts", "GITHUB_TOKEN": "your_github_token_here" } } ``` ## ๐Ÿ“ˆ **Impact** - **Reduced AI confusion**: Clear workflow guidance - **Better prompt discovery**: Search-first emphasis - **Fewer duplicates**: Mandatory search before create - **Improved error handling**: Helpful suggestions instead of dead ends - **GitHub integration**: Seamless prompt library management - **Scalable system**: Grows with your prompt library ## ๐ŸŽฏ **Next Steps** The Smart Prompts MCP Server is now production-ready with: - Clear AI guidance and workflow - Comprehensive error handling - Rich contextual help - GitHub integration - Scalable prompt library management Ready for advanced AI assistant workflows! ๐Ÿš€

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jezweb/smart-prompts-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server