Fetches prompts directly from GitHub repositories, with support for private repos via token authentication, specific branches and paths
Provides prompt templates specifically for JavaScript development best practices
Uses markdown files with YAML frontmatter for defining prompts and their metadata
Includes specialized prompts for React development, available through the prompt search and composition system
Leverages YAML frontmatter for rich prompt metadata including categories, tags, and argument definitions
Smart Prompts MCP Server
An enhanced MCP (Model Context Protocol) server that fetches prompts from GitHub repositories with intelligent discovery, composition, and management features. This is an enhanced fork of prompts-mcp-server with GitHub integration and advanced features.
๐ Key Features
Core Capabilities
๐ GitHub Integration: Fetch prompts directly from GitHub repositories (public/private)
๐ Smart Discovery: Advanced search with category and tag filtering
๐ Prompt Composition: Combine multiple prompts into workflows
๐ Usage Tracking: Analytics on prompt usage patterns
โก Real-time Updates: Automatic synchronization with GitHub
๐ค AI Guidance: Enhanced tool descriptions and workflow recommendations
MCP Protocol Support
Tools: 7 specialized tools for prompt management
Resources: 13+ resource endpoints for browsing and discovery
Prompts: Dynamic templates with Handlebars support
๐ Prerequisites
Before installation, ensure you have:
Node.js 18+ installed
npm or yarn package manager
Git installed and configured
GitHub account (for GitHub integration)
GitHub Personal Access Token (for private repos or to avoid rate limits)
๐ Installation
Step 1: Clone and Install
Step 2: Configure Environment
Create a .env
file in the project root:
Step 3: MCP Client Configuration
For Claude Desktop (macOS)
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
:
For Roo Cline (VS Code)
Add to Roo Cline MCP settings:
๐ Prompt Organization Best Practices
Recommended Folder Structure
Naming Conventions
Files: Use kebab-case (e.g.,
api-documentation-generator.md
)Prompt Names: Use snake_case in frontmatter (e.g.,
api_documentation_generator
)Categories: Use lowercase with hyphens (e.g.,
content-creation
)Keep names descriptive but concise
๐ Prompt File Format
๐ ๏ธ Available Tools
๐ - Always start here! Search by keyword, category, or tags
๐ - Browse available categories with counts
๐ - Retrieve specific prompt (use exact name from search)
โจ - Create new prompts in GitHub
๐ - Combine multiple prompts
โ - Get contextual help and guidance
โ - Verify GitHub connection
Recommended Workflow
๐ง Troubleshooting
Common Issues
1. "GitHub access failed" Error
2. "Rate limit exceeded" Error
Add a GitHub token to increase rate limits
Reduce cache refresh interval
Use
CACHE_TTL
to cache longer
3. "No prompts found"
Check repository structure matches expected format
Verify GITHUB_PATH if using subdirectory
Ensure .md files have YAML frontmatter
4. MCP Client Not Connecting
Use absolute paths in configuration
Check Node.js is in PATH
Verify all environment variables
Check logs:
tail -f ~/.claude/logs/mcp.log
5. Slow Performance
Increase
CACHE_TTL
for less frequent updatesReduce repository size (archive old prompts)
Use categories to limit search scope
๐ Scaling Considerations
Current Limitations
GitHub API Rate Limits
60 requests/hour (unauthenticated)
5,000 requests/hour (authenticated)
Each directory fetch = 1 request
Search Limitations
No native semantic search in GitHub
Linear search through all files
Performance degrades with 100+ prompts
Scaling Strategies
For 50-200 Prompts
โ Current implementation works well
Use categories and tags for organization
Implement local caching
Add GitHub token for higher rate limits
For 200-1000 Prompts
๐ Implement Index File
# INDEX.md in repo root prompts: - name: api_generator path: development/api-generator.md category: development tags: [api, codegen]๐ Add Search Index
Generate search index on build
Store in
search-index.json
Update via GitHub Actions
For 1000+ Prompts
๐๏ธ Database Layer
SQLite for local caching
Full-text search capabilities
Sync with GitHub periodically
๐ Elasticsearch/Algolia Integration
Proper search infrastructure
Faceted search
Relevance ranking
Future Scaling Features (Roadmap)
Search Index Generation
GitHub Action to build index
Download single index file
Local semantic search
Lazy Loading
Fetch categories on demand
Progressive enhancement
Virtual scrolling for large lists
CDN Support
Cache prompts at edge
Reduce GitHub API calls
Faster global access
๐ Future MCP Server Ideas
Building on the GitHub integration pattern, here are potential MCP servers:
1. Code Snippets MCP Server
Store and manage reusable code snippets in GitHub
Language-specific organization
Syntax highlighting
Dependency management
Version history
2. Documentation Templates MCP
GitHub-based documentation template library
README generators
API documentation templates
Project documentation
Auto-generated from code
3. AI Personas MCP Server
Manage AI personality configurations
Expertise definitions
Communication styles
Behavioral traits
Team sharing
4. Project Scaffolding MCP
Full project template management
Technology stacks
Boilerplate code
Best practices
Configuration presets
5. Learning Resources MCP
Curated educational content
Tutorials and guides
Code examples
Progress tracking
Skill-based recommendations
6. Configuration Manager MCP
Version-controlled app configs
Environment management
Secret handling
Team synchronization
Rollback support
7. Workflow Automation MCP
GitHub Actions integration
Workflow templates
CI/CD pipelines
Automation scripts
Cross-repo orchestration
8. Knowledge Base MCP
Team knowledge management
Q&A pairs
Troubleshooting guides
Best practices
Searchable wiki
๐งช Testing
The server includes comprehensive testing to ensure reliability and performance.
Test Suite Features
100% test coverage of critical functionality
Performance benchmarks with detailed metrics
Visual test reports with interactive charts
Automated CI/CD via GitHub Actions
Running Tests
Test Reports
Test results are automatically generated in multiple formats:
JSON: Detailed results for analysis (
test-results/latest.json
)Markdown: Human-readable reports (
test-results/latest.md
)HTML: Interactive visual reports (
test-results/latest.html
)
View the latest test results:
๐งช Development
๐ค Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
Priority Areas
Search Improvements
Implement fuzzy search
Add search result ranking
Support for regex patterns
Performance Optimization
Implement connection pooling
Add request batching
Optimize cache strategies
UI/Visualization
Web interface for browsing
Prompt preview tool
Usage analytics dashboard
๐ License
MIT License - see LICENSE file for details.
๐ Acknowledgments
Original prompts-mcp-server by @tanker327
Model Context Protocol by Anthropic
Built with inspiration from the MCP community
๐ Support
Issues: GitHub Issues
Discussions: GitHub Discussions
Examples: jezweb/prompts
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An enhanced MCP server that fetches prompts from GitHub repositories with intelligent discovery, composition, and management features.
- ๐ Key Features
- ๐ Prerequisites
- ๐ Installation
- ๐ Prompt Organization Best Practices
- ๐ Prompt File Format
- ๐ ๏ธ Available Tools
- ๐ง Troubleshooting
- ๐ Scaling Considerations
- ๐ Future MCP Server Ideas
- ๐งช Testing
- ๐งช Development
- ๐ค Contributing
- ๐ License
- ๐ Acknowledgments
- ๐ Support
Related MCP Servers
- -securityAlicense-qualityAn MCP server that enables clients to extract LLM-friendly prompts from documentation in GitHub repositories or hosted websites.Last updated -Apache 2.0
- -securityAlicense-qualityAn MCP server that enables AI assistants like Claude to help users manage their GitHub notifications through natural language commands.Last updated -016MIT License
- AsecurityAlicenseAqualityAn MCP server that enables analyzing and querying GitHub repositories through the GitHub Chat API, allowing users to index repositories and ask questions about their code, architecture and tech stack.Last updated -264MIT License
- MIT License