About Causly Server

Causly Server is a custom MCP (Model Context Protocol) server designed to give AI models like Claude full, direct control over your local machine and your core development stack. This includes managing your filesystem, Git repositories, shell commands, GitHub, Vercel, and Supabase workflows, all from a single, self-hosted server that you own. It's built as the core dev-automation layer for AI agency workflows and is open-sourced to allow other developers to run their own instances.

Key Features:

• File Operations: Supports a comprehensive set of file operations including read, write, create, delete, move, copy, and get file info.

• Directory Operations: Enables listing directories, generating directory trees, creating/deleting directories, and searching files.

• Git Operations: Integrates with Git for initialization, status checks, adding, committing, pushing, pulling, logging, diffing, and branching.

• Shell Execution: Allows running any shell command for tasks like installations, builds, and tests, with safeguards against destructive patterns.

• GitHub Integration: Facilitates GitHub actions such as getting user info, creating/deleting/listing repositories, creating/listing issues, creating/listing pull requests, and adding comments.

• Vercel Integration: Enables Vercel operations including getting user info, listing/getting/creating/deleting projects, and listing/getting/creating deployments.

• Supabase Integration: Supports Supabase actions like listing organizations/projects, getting/creating/deleting projects, and running SQL commands.

• Logging: All tool calls are logged locally to logs/activity.log for auditability.

Workflow Enabled:

This server enables a seamless workflow where you describe a task to an AI model, and the model can then directly edit or create files, run commands, commit changes to Git, manage GitHub issues and pull requests, interact with Supabase for database operations, and trigger Vercel deployments, all without leaving the conversation.

Requirements:

• Node.js 18+

• Claude Desktop

Setup:

1. Clone the repository.

2. Install dependencies using npm install.

3. Run the interactive setup wizard with npm run setup, which configures your environment and Claude Desktop. Alternatively, manually configure the .env file and Claude Desktop's mcpServers setting.

4. Restart Claude Desktop to enable the tools.

Security Note:

This server is designed for trusted, single-user local setups and runs with unrestricted access. For shared environments, implement path allow-listing and stricter permission scoping.