stackmcp
v1.2.9
Published
Orchestrate your MCP servers — run stacks, track history, discover patterns
Readme
stackmcp.io
Orchestrate your MCP servers — combine tools into reusable stacks, track execution history, and discover patterns.
curl -fsSL https://stackmcp.io/install.sh | sh
stackmcp init
stackmcp daemon start
stackmcp stacksWhat it does
StackMCP runs a local daemon that connects to your MCP servers and gives you a unified CLI and API on top of them:
- Execute tools — call any tool from any MCP server through one endpoint
- Run stacks — chain tools into reusable workflows (
fetch-to-obsidian,youtube-to-obsidian, etc.) - Track history — every tool call and stack execution is recorded
- Discover patterns — the recommendations engine surfaces repeated sequences
Quickstart
# 1. Interactive setup — picks MCP servers to enable
stackmcp init
# 2. Start the daemon (auto-starts when you run any command)
stackmcp daemon start
# 3. List available stacks
stackmcp stacks
# 4. Run a stack
stackmcp run fetch-url --url "https://example.com"
stackmcp run fetch-to-obsidian --url "https://serpapi.com/blog/the-state-of-mcp"Example stacks
| Stack | What it does |
|---|---|
| fetch-url | Fetch any URL and get the content |
| fetch-to-obsidian | Fetch a URL and save to Obsidian |
| youtube-transcript | Get transcript of any YouTube video |
| youtube-to-obsidian | Transcribe video and save as note |
| deepseek-chat | Chat with DeepSeek AI |
| github-search-repos | Search GitHub repositories |
| calendar-to-obsidian | Log today's events to Obsidian |
| puppeteer-screenshot | Screenshot a webpage |
CLI
stackmcp stacks List stacks
stackmcp run <id> --key val Execute a stack
stackmcp history Recent executions
stackmcp recommendations Repeated pattern insights
stackmcp init Interactive server setup
stackmcp daemon start|stop Manage the daemonHow it works
CLI ──HTTP──▶ Daemon (port 3001)
│
├── Filesystem MCP
├── Fetch MCP
├── GitHub MCP
├── Obsidian MCP
├── YouTube MCP
└── ... (any MCP server)The daemon starts all configured MCP servers, aggregates their tools, and exposes a REST API. Stacks define multi-step workflows where tool outputs flow to downstream tools automatically.
Requirements
- Node.js 18+
- An MCP server to connect (or use the built-in Fetch, Filesystem servers)
Development
npm install
npm run daemon # Start the daemon
node bin/stackmcp stacks # Run CLI commands
bash test/cli-smoke.sh # Smoke tests