@sidebutton/server
v1.0.1
Published
SideButton server with MCP integration, REST API, and web dashboard for workflow automation
Readme
@sidebutton/server
SideButton server with MCP integration, REST API, and web dashboard for workflow automation.
Installation
npm install @sidebutton/serverQuick Start
# Start the server
npx sidebutton serve
# Open http://localhost:9876Features
- Web Dashboard - Visual workflow management UI
- MCP Server - Model Context Protocol for AI agents (Claude Code, Cursor)
- REST API - JSON endpoints for mobile and external integrations
- Chrome Extension - Browser automation via WebSocket
- CLI - Command-line interface for workflow management
CLI Commands
sidebutton serve # Start server on port 9876
sidebutton list # List available workflows
sidebutton run <id> # Run a workflow by ID
sidebutton status # Check server statusMCP Integration
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"sidebutton": {
"type": "sse",
"url": "http://localhost:9876/mcp"
}
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"sidebutton": {
"url": "http://localhost:9876/mcp"
}
}
}MCP Tools
| Tool | Description |
|------|-------------|
| run_workflow | Execute a workflow by ID |
| list_workflows | List available workflows |
| get_workflow | Get workflow YAML definition |
| get_run_log | Get execution log |
| list_run_logs | List recent executions |
| get_browser_status | Check extension connection |
| capture_page | Capture page selectors |
| navigate | Navigate browser to URL |
| snapshot | Get accessibility tree |
| click | Click element |
| type | Type text |
| scroll | Scroll page |
| extract | Extract text |
| screenshot | Capture screenshot |
| hover | Hover over element |
Documentation
Related Packages
@sidebutton/core- Core workflow engine
License
Apache-2.0
