wastebin-mcp-go/.env.example
opencode-agent[bot] 6a20002204
docs: fix .env.example and INSTALL.md (#223)
* Fixed .env.example + INSTALL.md, verify passes.

Co-authored-by: xlionjuan <[email protected]>

* Added doc sync test.

Co-authored-by: xlionjuan <[email protected]>

* Merged main, fixed test, added bidirectional check.

Co-authored-by: xlionjuan <[email protected]>

---------

Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>
Co-authored-by: xlionjuan <[email protected]>
2026-07-22 05:28:44 +08:00

80 lines
3.9 KiB
Shell

# Wastebin MCP Server Configuration
#
# Copy this file to .env and adjust values for your environment.
# The .env file is NOT read automatically — set these as environment variables
# in your MCP client configuration or shell.
# ── Required ─────────────────────────────────────────────────────────────────
# URL of the Wastebin server instance.
# Required - Wastebin server URL
# Use bin-staging.xlion.tw for testing; change to bin.xlion.tw for production
WASTEBIN_SERVER_URL=https://bin-staging.xlion.tw
# ── Optional (defaults shown) ────────────────────────────────────────────────
# Enable file-read mode, allowing the create_paste tool to read local files.
# Set to "false" to disable file reading entirely (only inline content mode).
# Default: true
# WASTEBIN_MCP_FILE_READ_ENABLED=true
# Default paste expiration in seconds when no expires parameter is given.
# Default: 31536000 (1 year)
# WASTEBIN_MCP_DEFAULT_EXPIRES=31536000
# Comma-separated list of absolute directory paths allowed for file reads.
# When file-read mode is enabled and this is empty, the server falls through
# to the two-tier blocklist (built-in system directory prefixes + built-in
# sensitive path components + user blocklist).
# Default: (empty — only built-in and user blocklists apply)
# WASTEBIN_MCP_ALLOWED_PATHS=/home/user/documents,/tmp
# Comma-separated list of absolute directory paths to block from file reads.
# The allowlist (ALLOWED_PATHS) takes precedence over entries in this list.
# Empty by default — the built-in blocklist handles system directories
# (/etc, /proc, /sys, /dev) and sensitive components (.ssh, .gnupg, etc.)
# separately. Set WASTEBIN_MCP_DISABLE_BUILTIN_BLOCKLIST=true to disable those.
# Default: (empty — built-in blocklist handles system paths)
# WASTEBIN_MCP_BLOCKED_PATHS=/home/user/secret
# Maximum paste content size in bytes. Applied client-side before upload
# to fail fast on oversized content.
# Default: 1048576 (1 MB)
# WASTEBIN_MCP_MAX_CONTENT_SIZE=1048576
# Disable the built-in blocklist, which includes:
# - System directory prefixes: /etc, /proc, /sys, /dev
# - Sensitive path components: .ssh, .gnupg, .aws, .kube, .docker, .git
# When true, only the user-configured blocklist (WASTEBIN_MCP_BLOCKED_PATHS)
# and allowlist (WASTEBIN_MCP_ALLOWED_PATHS) apply. Note that
# WASTEBIN_MCP_BLOCKED_PATHS is empty by default, so setting this to true
# effectively allows all paths unless an explicit blocklist or allowlist
# is configured.
# Default: false
# WASTEBIN_MCP_DISABLE_BUILTIN_BLOCKLIST=true
# Allow password-protected pastes over non-loopback HTTP connections.
# By default, password-protected pastes are rejected when using http://
# with a non-loopback host. Loopback addresses (localhost, 127.0.0.1, ::1)
# are always allowed with a warning. Only enable if you understand the risk
# of sending passwords in cleartext — prefer https:// in production.
# Default: false
# WASTEBIN_MCP_ALLOW_INSECURE_PASSWORD=false
# Sandbox mount mappings in Docker format: host_path:sandbox_path pairs,
# comma-separated. Enables sandbox-path translation for container deployments.
# Example: /home/user/workspace:/workspace
# Default: (empty — sandbox translation disabled)
# WASTEBIN_MCP_SANDBOX_MOUNTS=
# When true, sandbox path translation happens automatically without requiring
# an explicit parameter. The translate_sandbox_path parameter is hidden from
# the tool schema.
# Default: false
# WASTEBIN_MCP_SANDBOX_TRANSPARENT=false
# Enable debug logging (sparse slog.Debug entries on stderr — paste submission
# info, sandbox translation, error details; not an HTTP wire dump).
# Set to "1" or "true" to enable. Same effect as --debug CLI flag.
# Default: (not set — debug logging disabled)
# DEBUG=1