watercooler-cloud
Verified Safeby mostlyharmless-ai
Overview
Facilitates asynchronous collaboration and knowledge management for AI agents by managing markdown-based discussion threads and syncing them via Git, with advanced features for branch parity and knowledge graph generation.
Installation
python -m watercooler_mcpEnvironment Variables
- WATERCOOLER_AGENT
- WATERCOOLER_DIR
- WATERCOOLER_CODE_REPO
- WATERCOOLER_GIT_REPO
- WATERCOOLER_THREADS_BASE
- WATERCOOLER_THREADS_PATTERN
- WATERCOOLER_THREADS_AUTO_PROVISION
- WATERCOOLER_THREADS_CREATE_CMD
- WATERCOOLER_GITHUB_TOKEN
- WATERCOOLER_GIT_SSH_KEY
- DEEPSEEK_API_KEY
- EMBEDDING_API_KEY
- LEANRAG_DIR
- LLM_API_BASE
- EMBEDDING_API_BASE
- WATERCOOLER_MCP_TRANSPORT
- WATERCOOLER_MCP_HOST
- WATERCOOLER_MCP_PORT
- WATERCOOLER_SYNC_LOG
- WATERCOOLER_ASYNC_SYNC
- WATERCOOLER_LOG_LEVEL
- WATERCOOLER_CACHE_DIR
Security Notes
The `provisioning.py` module uses `subprocess.run(command, shell=True)` for `WATERCOOLER_THREADS_CREATE_CMD`. This is an opt-in feature where `command` is formatted from an environment variable. If `WATERCOOLER_THREADS_CREATE_CMD` is not securely configured by the deployer, it can lead to command injection. Other Git operations primarily use GitPython or direct `subprocess` calls with specific environment settings (`GIT_ASKPASS`, `GIT_SSH_COMMAND`) that attempt to mitigate interactive prompts and potential credential exposure, and `shlex.quote` is used where appropriate. Sensitive information is redacted from logs by `_redact_sensitive` function. Overall, careful environment configuration is crucial for security.
Similar Servers
git-mcp-server
A Model Context Protocol (MCP) server that provides Git-specific tools and resources for AI/LLM agents to interact with version control systems.
mcp-agentic-sdlc
A comprehensive framework for managing software development lifecycle with AI agents, combining structured development processes with intelligent workflow management.
mcp-tasks
Manages development tasks and workflows for AI agents using the Model Context Protocol (MCP), enabling persistent planning, category-based organization, and story-based development.
backlog
Manage project backlog and tasks using Markdown files in a Git repository, designed for frictionless collaboration between AI agents and human developers.