Sync from internal 744c24e3

Author: fnops

.env.example

@@ -0,0 +1,21 @@
+# Authentication — choose ONE method:
+#
+# Option A: API Token (recommended)
+# BITBUCKET_API_TOKEN=your-api-token
+#
+# Option B: App Password (legacy — being deprecated by Bitbucket)
+BITBUCKET_USERNAME=your-email@company.com
+BITBUCKET_APP_PASSWORD=your-app-password
+
+# Required
+BITBUCKET_WORKSPACE=your-workspace-slug
+
+# Optional — defaults shown
+# BITBUCKET_API_URL=https://api.bitbucket.org/2.0
+# LOG_LEVEL=info
+# NODE_ENV=production
+
+# Transport mode: "stdio" (default, local dev) or "http" (VPC service)
+# MCP_TRANSPORT=stdio
+# MCP_PORT=3000
+# MCP_HOST=0.0.0.0

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Typecheck, Lint & Test
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [22, 24]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci --ignore-scripts
+      - run: npx tsc --noEmit
+      - run: npm run lint
+      - run: npm test
+
+  docker:
+    name: Docker Build
+    runs-on: ubuntu-latest
+    needs: validate
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          tags: bitbucket-mcp-server:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -0,0 +1,27 @@
+# ── Build artifacts ───────────────────────────────────────────────────────────
+build/
+dist/
+
+# ── Dependencies ─────────────────────────────────────────────────────────────
+node_modules/
+
+# ── Env / secrets ────────────────────────────────────────────────────────────
+.env
+.env.local
+.env.*.local
+
+# ── IDE / OS ─────────────────────────────────────────────────────────────────
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# ── Test / coverage ──────────────────────────────────────────────────────────
+coverage/
+*.lcov
+
+# ── Misc ─────────────────────────────────────────────────────────────────────
+*.log
+npm-debug.log*

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2
+}