About Prompts
Prompts is an MCP server published by sparesparrow in the AI category: model Context Protocol server for managing, storing, and providing prompts and prompt templates for LLM interactions.
The repository has 118 stars and 20 forks, with the last commit 13 hours ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add prompts -- npx -y @hasna/promptsnpx -y @hasna/promptsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
apply_templateApply variables to template string
Parameters not published.
create_promptAdd new prompt to repository
Parameters not published.
delete_promptRemove prompt
Parameters not published.
get_promptRetrieve specific prompt with template expansion
Parameters not published.
get_statsRepository statistics
Parameters not published.
list_promptsQuery prompts with filters (tags, search, category)
Parameters not published.
update_promptModify existing prompt
Parameters not published.
Ask AI
Ask AI about Prompts
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
mcp-prompts
Simple MCP server for managing AI prompts and agent configurations with direct claude CLI orchestration.
What It Does
- Stores prompts as JSON files in
data/prompts/ - Exposes MCP tools for querying and managing prompts
- Provides agent templates for project orchestration
- Works with Claude Desktop, Cursor, and other MCP clients
Packages
- npm:
@sparesparrow/mcp-prompts - Docker Hub:
sparesparrow/mcp-prompts
Published releases lag behind main. To run what this README describes, build from source as below.
Quick Start
1. Install
pnpm install
pnpm build
2. Start MCP Server
pnpm start
3. Configure your MCP client
For Claude Desktop, add to claude_desktop_config.json (other clients take the same command and env):
{
"mcpServers": {
"prompts": {
"command": "node",
"args": ["/absolute/path/to/mcp-prompts/dist/mcp-server-standalone.js"],
"env": {
"PROMPTS_DIR": "/absolute/path/to/mcp-prompts/data/prompts"
}
}
}
}
4. Use in Claude
Ask Claude:
- "List all prompts tagged with esp32"
- "Get the esp32-fft-configuration-guide prompt"
- "Create a new prompt for Python FastAPI best practices"
Orchestrating Projects
Use the orchestrate script to analyze entire projects:
./scripts/orchestrate-project.sh ~/projects/mia analyze
./scripts/orchestrate-project.sh ~/projects/esp32-bpm-detector review
This automatically:
- Detects project type
- Loads appropriate main agent
- Spawns specialized subagents
- Runs comprehensive analysis
- Returns structured results
MCP Tools
| Tool | Description |
|---|---|
list_prompts |
List prompts, filtered by tags or a search term |
get_prompt |
Retrieve a prompt by ID |
add_prompt |
Add a new prompt or template |
update_prompt |
Modify existing prompt |
delete_prompt |
Remove prompt |
apply_template |
Fill a template prompt's {{variables}} |
get_stats |
Repository statistics |
Prompts Organization
data/prompts/
├── main-agents/ # 7 project orchestration templates
│ ├── main_agent_python_backend.json
│ ├── main_agent_cpp_backend.json
│ ├── main_agent_android_app.json
│ ├── main_agent_embedded_iot.json
│ ├── main_agent_multiplatform_iot.json
│ └── ...
│
├── subagents/ # 19 specialized analysis agents
│ ├── explorer.json # Project discovery
│ ├── analyzer.json # Code analysis
│ ├── diagrammer.json # Diagram generation
│ ├── solid_analyzer.json # Code quality
│ └── ...
│
├── cognitive/ # 7-layer cognitive architecture
├── esp32/ # Embedded systems patterns
├── mcp-tools/ # MCP usage patterns
└── [domains]/ # Domain-specific knowledge
Architecture
Simple and focused:
┌──────────────────────────────┐
│ MCP Server (stdio) │
│ ├── list_prompts │
│ ├── get_prompt │
│ ├── create_prompt │
│ └── ... │
├──────────────────────────────┤
│ File Storage │
│ └── data/prompts/*.json │
└──────────────────────────────┘
Orchestration:
orchestrate-project.sh
↓ loads prompts
↓ builds agent config
↓ calls claude CLI
Actual agent execution
Development
pnpm install # Install dependencies
pnpm build # Build TypeScript
pnpm dev # Watch mode
pnpm test # Run tests
pnpm orchestrate # Test orchestration
Enterprise Deployment
For enterprise features (AWS, multi-tenant, payments), see archive/aws/README.md.
Most users don't need this - the local MCP server is sufficient.
License
MIT
README fetched from the repository 6 hours ago. The original is authoritative.