better-confluence-mcp 0.1.0__tar.gz

better_confluence_mcp-0.1.0/.devcontainer/Dockerfile

@@ -0,0 +1,3 @@
+FROM "mcr.microsoft.com/devcontainers/python:3.10"
+RUN curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="/usr/local/bin" sh
+ENV UV_LINK_MODE=copy

better_confluence_mcp-0.1.0/.devcontainer/devcontainer.json

@@ -0,0 +1,35 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Python 3 Project",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	//"image": "mcr.microsoft.com/devcontainers/python:3",
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+	"containerEnv": {
+		"PYTHONPATH": "./src"
+	},
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {}
+	},
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [
+		3000
+	],
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": ".devcontainer/post-create.sh",
+	"postStartCommand": ".devcontainer/post-start.sh",
+	// Configure tool-specific properties.
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.mypy-type-checker",
+				"charliermarsh.ruff"
+			]
+		}
+	}
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

better_confluence_mcp-0.1.0/.devcontainer/post-create.sh

@@ -0,0 +1,5 @@
+#! /bin/bash
+set -xe
+
+uv venv
+source .venv/bin/activate

better_confluence_mcp-0.1.0/.devcontainer/post-start.sh

@@ -0,0 +1,8 @@
+#! /bin/bash
+
+set -xe
+
+source .venv/bin/activate
+
+uv sync --frozen --all-extras --dev
+pre-commit install

better_confluence_mcp-0.1.0/.dockerignore

@@ -0,0 +1,53 @@
+# Version control
+.git
+.gitignore
+.github
+
+# Virtual environments
+.venv*
+venv*
+env*
+
+# Python bytecode/cache
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache
+.coverage
+.mypy_cache
+.ruff_cache
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Environment variables and secrets
+.env*
+*.env
+*.key
+
+# Logs
+*.log
+
+# Docker related
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Documentation
+docs/
+*.md
+!README.md
+
+# Temporal and backup files
+*.tmp
+*.bak
+*.backup

better_confluence_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,119 @@
+name: "\U0001F41B Bug Report"
+description: Create a report to help us improve better-confluence-mcp
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! Please provide as much detail as possible.
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Please confirm the following before submitting the issue.
+      options:
+        - label: I have searched the [existing issues](https://github.com/twinity1/better-confluence-mcp/issues) to make sure this bug has not already been reported.
+          required: true
+        - label: I have checked the [README](https://github.com/twinity1/better-confluence-mcp/blob/main/README.md) for relevant information.
+          required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: "When I call the `sync_space` tool with..., it fails with..."
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Provide detailed steps to reproduce the behavior.
+      placeholder: |
+        1. Start the server with command `...`
+        2. Send a `list_tools` request using `...`
+        3. Call the tool `xyz` with arguments `...`
+        4. See error `...`
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: "I expected the Confluence space to be synced successfully."
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened? Include full error messages, logs (from the server and the client if possible), or screenshots.
+      placeholder: "The server returned an error message: '...' / The tool call returned an empty list."
+      render: shell
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: better-confluence-mcp Version
+      description: Which version of `better-confluence-mcp` are you using?
+      placeholder: "e.g., 0.6.5"
+    validations:
+      required: true
+  - type: dropdown
+    id: installation
+    attributes:
+      label: Installation Method
+      description: How did you install `better-confluence-mcp`?
+      options:
+        - From PyPI (pip install better-confluence-mcp / uvx better-confluence-mcp)
+        - From source (git clone)
+        - Docker
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      description: What operating system are you using?
+      options:
+        - Windows
+        - macOS
+        - Linux (Specify distribution below if relevant)
+        - Other
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: What version of Python are you using? (`python --version`)
+      placeholder: "e.g., 3.11.4"
+    validations:
+      required: true
+  - type: dropdown
+    id: atlassian-instance
+    attributes:
+      label: Confluence Instance Type
+      description: Are you connecting to Confluence Cloud or Server/Data Center?
+      options:
+        - Confluence Cloud
+        - Confluence Server / Data Center
+    validations:
+      required: true
+  - type: input
+    id: client-app
+    attributes:
+      label: Client Application
+      description: What application/library are you using to interact with the MCP server? (This is important!)
+      placeholder: "e.g., Claude Code, Cursor, Windsurf, custom script"
+    validations:
+      required: true
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here (e.g., environment variables, network configuration like proxies, specific Confluence setup).

better_confluence_mcp-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: "\U0001F4AC Ask a Question or Discuss"
+    url: https://github.com/sooperset/mcp-atlassian/discussions # GitHub Discussions 링크 (활성화되어 있다면)
+    about: Please ask and answer questions here, or start a general discussion.
+  - name: "\U0001F4DA Read the Documentation"
+    url: https://github.com/sooperset/mcp-atlassian/blob/main/README.md
+    about: Check the README for setup and usage instructions.

better_confluence_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,42 @@
+name: "\U0001F680 Feature Request"
+description: Suggest an idea or enhancement for mcp-atlassian
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an idea! Please describe your proposal clearly.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: A clear and concise description of what the problem is.
+      placeholder: "e.g., I'm always frustrated when [...] because [...]"
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen. How should the feature work?
+      placeholder: "Add a new tool `confluence_move_page` that takes `page_id` and `target_parent_id` arguments..."
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+      placeholder: "I considered modifying the `confluence_update_page` tool, but..."
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: How would this feature benefit users? Who is the target audience?
+      placeholder: "This would allow AI agents to automatically organize documentation..."
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or links about the feature request here.

better_confluence_mcp-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,31 @@
+<!-- Thank you for your contribution! Please provide a brief summary. -->
+
+## Description
+
+<!-- What does this PR do? Why is it needed? -->
+<!-- Link related issues: Fixes #<issue_number> -->
+
+Fixes: #
+
+## Changes
+
+<!-- Briefly list the key changes made. -->
+
+-
+-
+-
+
+## Testing
+
+<!-- How did you test these changes? (e.g., unit tests, integration tests, manual checks) -->
+
+- [ ] Unit tests added/updated
+- [ ] Integration tests passed
+- [ ] Manual checks performed: `[briefly describe]`
+
+## Checklist
+
+- [ ] Code follows project style guidelines (linting passes).
+- [ ] Tests added/updated for changes.
+- [ ] All tests pass locally.
+- [ ] Documentation updated (if needed).

better_confluence_mcp-0.1.0/.github/workflows/docker-publish.yml

@@ -0,0 +1,77 @@
+name: Docker Publish
+
+on:
+  push:
+    tags:
+      - 'v*.*.*' # Trigger on version tag pushes (e.g., v0.7.1)
+  pull_request:
+    branches:
+      - main     # Trigger on PRs targeting main branch
+  workflow_dispatch: {} # Allow manual triggering from the Actions tab
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read  # Needed for checkout
+      packages: write # Needed to push packages to ghcr.io
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64,amd64
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      # Extract metadata (tags, labels) for Docker
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            # Create 'main' tag on push to main branch
+            type=ref,event=branch,branch=main
+            # Create 'X.Y.Z', 'X.Y', 'X' tags on tag push (e.g., v1.2.3 -> 1.2.3, 1.2, 1)
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            # Only create 'latest' tag if it's a tag push AND it's a non-prerelease version tag (no '-')
+            type=raw,value=latest,enable=${{ github.ref_type == 'tag' && startsWith(github.ref, 'refs/tags/v') && !contains(github.ref, '-') }}
+            # Create a tag for PRs (e.g., pr-123) - useful for testing PR builds
+            type=ref,event=pr
+            # For manual workflow runs, use branch name with 'manual' suffix
+            type=raw,value={{branch}}-manual,enable=${{ github.event_name == 'workflow_dispatch' }}
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        # Only login for pushes and manual runs, not for PRs
+        if: github.event_name != 'pull_request'
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push Docker image
+        id: docker_build
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          # Only push for non-PR events
+          push: ${{ github.event_name != 'pull_request' }}
+          # Use tags and labels from metadata action
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          # Enable Docker layer caching
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

better_confluence_mcp-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: Lint
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install .[dev]
+
+      - name: Run pre-commit
+        uses: pre-commit/action@v3.0.0

better_confluence_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+# .github/workflows/publish.yml
+name: Publish MCP-Atlassian to PyPI
+
+on:
+  release:
+    types: [published] # Triggers when a GitHub Release is published
+  workflow_dispatch:   # Allows manual triggering
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mcp-atlassian # Link to your PyPI package
+    permissions:
+      id-token: write # Necessary for PyPI's trusted publishing
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required for uv-dynamic-versioning to get tags
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10" # Or your minimum supported Python
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish package to PyPI
+        run: uv publish --token ${{ secrets.PYPI_API_TOKEN }} dist/*
+        # If using trusted publishing (recommended), remove --token and configure it in PyPI:
+        # run: uv publish dist/*

better_confluence_mcp-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,53 @@
+name: 'Manage Stale Issues and PRs'
+
+on:
+  schedule:
+    # Runs daily at midnight UTC
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          # === Core Timing Settings ===
+          days-before-stale: 14 # Start with 2 weeks
+          days-before-close: -1 # Disable automatic closing initially
+
+          # === Labels ===
+          stale-issue-label: 'stale'
+          stale-pr-label: 'stale'
+
+          # === Bot Messages ===
+          stale-issue-message: >
+            This issue has been automatically marked as stale because it has not had
+            recent activity for 14 days. It will be closed if no further activity occurs.
+            Please leave a comment or remove the 'stale' label if you believe this issue is still relevant.
+            Thank you for your contributions!
+          stale-pr-message: >
+            This pull request has been automatically marked as stale because it has not had
+            recent activity for 14 days. It will be closed if no further activity occurs.
+            Please leave a comment or remove the 'stale' label if you believe this PR is still relevant.
+            Thank you for your contributions!
+
+          # === Exemptions ===
+          exempt-issue-labels: 'pinned,security,good first issue,help wanted,bug,enhancement,feature request,documentation,awaiting-user-feedback,needs-investigation'
+          exempt-pr-labels: 'pinned,security,work-in-progress,awaiting-review,do-not-merge'
+          exempt-all-milestones: true
+          exempt-all-assignees: false # Consider if most issues should have assignees
+          exempt-draft-pr: true
+
+          # === Behavior Control ===
+          remove-stale-when-updated: true
+          operations-per-run: 30
+          debug-only: false
+          delete-branch: false
+
+          # --- Statistics ---
+          enable-statistics: true

better_confluence_mcp-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,42 @@
+# .github/workflows/tests.yml
+
+name: Run Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Run pytest on Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "0.6.10"
+        cache: true
+
+    - name: Install dependencies
+      run: uv sync --frozen --all-extras --dev
+
+    - name: Run tests with pytest
+      # Add -v for verbose output, helpful in CI
+      # Add basic coverage reporting to terminal logs
+      # Skip real API validation tests as they require credentials
+      run: uv run pytest -v -k "not test_real_api_validation" --cov=src/mcp_atlassian --cov-report=term-missing

better_confluence_mcp-0.1.0/.gitignore

@@ -0,0 +1,80 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Environments
+.env
+.env.*
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv/uvx specific
+.uv/
+.uvx/
+.venv.uv/
+
+# IDEs and editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS specific
+.DS_Store
+Thumbs.db
+
+# Debug and local development
+debug/
+local/
+
+# Credentials
+.pypirc
+
+# Pytest
+.pytest_cache/
+.coverage/
+.coverage
+
+# Pre-commit
+.pre-commit-config.yaml.cache
+
+# debug
+playground/
+
+# cursor
+.cursor*
+
+# Claude
+.claude/
+
+# Local Confluence cache
+.better-confluence-mcp/