ultimate-gemini-mcp 1.0.1__tar.gz

ultimate_gemini_mcp-1.0.1/.env.example

@@ -0,0 +1,34 @@
+# Ultimate Gemini MCP Server Configuration
+
+# Required: Your Google Gemini API Key
+# Get one from: https://makersuite.google.com/app/apikey
+GEMINI_API_KEY=your_api_key_here
+
+# Alternative API key name (either works)
+# GOOGLE_API_KEY=your_api_key_here
+
+# Optional: Output directory for generated images (default: generated_images)
+# OUTPUT_DIR=./generated_images
+
+# Optional: Enable/disable prompt enhancement (default: true)
+# ENABLE_PROMPT_ENHANCEMENT=true
+
+# Optional: Enable/disable batch processing (default: true)
+# ENABLE_BATCH_PROCESSING=true
+
+# Optional: Default models
+# DEFAULT_GEMINI_MODEL=gemini-2.5-flash-image
+# DEFAULT_IMAGEN_MODEL=imagen-4-ultra
+
+# Optional: Request settings
+# REQUEST_TIMEOUT=60
+# MAX_BATCH_SIZE=8
+# MAX_RETRIES=3
+
+# Optional: Default generation settings
+# DEFAULT_ASPECT_RATIO=1:1
+# DEFAULT_OUTPUT_FORMAT=png
+
+# Optional: Logging
+# LOG_LEVEL=INFO
+# LOG_FORMAT=standard

ultimate_gemini_mcp-1.0.1/.github/workflows/README.md

@@ -0,0 +1,74 @@
+# GitHub Actions Workflows
+
+## Publish to PyPI
+
+The `publish.yml` workflow automatically versions and publishes the package to PyPI.
+
+### Automatic Versioning
+
+The workflow automatically increments the version based on commit messages:
+
+- **Patch bump** (default): `1.0.0` → `1.0.1`
+  - Used for bug fixes and minor changes
+  - No special keyword needed
+
+- **Minor bump**: `1.0.0` → `1.1.0`
+  - Add `[minor]` to your commit message
+  - Used for new features
+
+- **Major bump**: `1.0.0` → `2.0.0`
+  - Add `[major]` to your commit message
+  - Used for breaking changes
+
+### Examples
+
+```bash
+# Patch version (1.0.0 → 1.0.1)
+git commit -m "Fix image saving bug"
+git push origin main
+
+# Minor version (1.0.0 → 1.1.0)
+git commit -m "[minor] Add support for new aspect ratios"
+git push origin main
+
+# Major version (1.0.0 → 2.0.0)
+git commit -m "[major] Complete API redesign with breaking changes"
+git push origin main
+```
+
+### Manual Trigger
+
+You can also manually trigger a release from the GitHub Actions tab:
+
+1. Go to Actions → Publish to PyPI
+2. Click "Run workflow"
+3. Select the version bump type (major/minor/patch)
+4. Click "Run workflow"
+
+### What Happens
+
+When you push to main:
+
+1. ✅ Detects version bump type from commit message
+2. ✅ Increments version in `pyproject.toml` and `src/__init__.py`
+3. ✅ Commits the version bump with `[skip ci]` to avoid infinite loops
+4. ✅ Creates a git tag (e.g., `v1.0.1`)
+5. ✅ Builds the Python package
+6. ✅ Publishes to PyPI using `PYPI_API_TOKEN` secret
+7. ✅ Creates a GitHub Release with changelog
+
+### Requirements
+
+- `PYPI_API_TOKEN` secret must be configured in repository settings
+- Python 3.11+ for building
+- uv for fast builds and dependency management
+
+### Skipping CI
+
+To prevent the workflow from running on a commit, add `[skip ci]` to the commit message:
+
+```bash
+git commit -m "Update README [skip ci]"
+```
+
+This is automatically added to version bump commits to prevent infinite loops.

ultimate_gemini_mcp-1.0.1/.github/workflows/claude-code-review.yml

@@ -0,0 +1,57 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

ultimate_gemini_mcp-1.0.1/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

ultimate_gemini_mcp-1.0.1/.github/workflows/publish.yml

@@ -0,0 +1,161 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      version_bump:
+        description: 'Version bump type'
+        required: false
+        default: 'patch'
+        type: choice
+        options:
+          - major
+          - minor
+          - patch
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: |
+          uv pip install --system toml packaging
+
+      - name: Determine version bump type
+        id: bump_type
+        run: |
+          # Check if manual workflow dispatch
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "type=${{ inputs.version_bump }}" >> $GITHUB_OUTPUT
+          else
+            # Check commit message for version bump indicators
+            COMMIT_MSG=$(git log -1 --pretty=%B)
+            if echo "$COMMIT_MSG" | grep -iq "\[major\]"; then
+              echo "type=major" >> $GITHUB_OUTPUT
+            elif echo "$COMMIT_MSG" | grep -iq "\[minor\]"; then
+              echo "type=minor" >> $GITHUB_OUTPUT
+            else
+              echo "type=patch" >> $GITHUB_OUTPUT
+            fi
+          fi
+
+      - name: Bump version
+        id: version
+        run: |
+          python << 'EOF'
+          import os
+          import toml
+          import sys
+          from packaging import version
+
+          # Read current version
+          with open('pyproject.toml', 'r') as f:
+              data = toml.load(f)
+
+          current = version.parse(data['project']['version'])
+          bump_type = "${{ steps.bump_type.outputs.type }}"
+
+          # Calculate new version
+          if bump_type == 'major':
+              new_version = f"{current.major + 1}.0.0"
+          elif bump_type == 'minor':
+              new_version = f"{current.major}.{current.minor + 1}.0"
+          else:  # patch
+              new_version = f"{current.major}.{current.minor}.{current.micro + 1}"
+
+          # Update pyproject.toml
+          data['project']['version'] = new_version
+          with open('pyproject.toml', 'w') as f:
+              toml.dump(data, f)
+
+          # Update src/__init__.py
+          with open('src/__init__.py', 'r') as f:
+              content = f.read()
+
+          content = content.replace(
+              f'__version__ = "{current}"',
+              f'__version__ = "{new_version}"'
+          )
+
+          with open('src/__init__.py', 'w') as f:
+              f.write(content)
+
+          print(f"new_version={new_version}")
+          with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
+              f.write(f"new_version={new_version}\n")
+              f.write(f"old_version={current}\n")
+          EOF
+
+      - name: Commit version bump
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add pyproject.toml src/__init__.py
+          git commit -m "Bump version: ${{ steps.version.outputs.old_version }} → ${{ steps.version.outputs.new_version }} [skip ci]"
+          git tag -a "v${{ steps.version.outputs.new_version }}" -m "Release v${{ steps.version.outputs.new_version }}"
+
+      - name: Push changes
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: main
+          tags: true
+
+      - name: Build package
+        run: |
+          uv build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          uv pip install --system twine
+          twine upload dist/*
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: v${{ steps.version.outputs.new_version }}
+          name: Release v${{ steps.version.outputs.new_version }}
+          body: |
+            ## Changes in v${{ steps.version.outputs.new_version }}
+
+            **Version bump:** ${{ steps.bump_type.outputs.type }}
+            **Previous version:** ${{ steps.version.outputs.old_version }}
+
+            ### Installation
+            ```bash
+            pip install ultimate-gemini-mcp==${{ steps.version.outputs.new_version }}
+            ```
+
+            Or with uv:
+            ```bash
+            uvx ultimate-gemini-mcp@${{ steps.version.outputs.new_version }}
+            ```
+
+            See the [README](https://github.com/${{ github.repository }}/blob/main/README.md) for full documentation.
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

ultimate_gemini_mcp-1.0.1/.github/workflows/test.yml

@@ -0,0 +1,106 @@
+name: Tests and Linting
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - '**.md'
+      - '.github/workflows/publish.yml'
+
+jobs:
+  lint:
+    name: Lint Code
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: |
+          uv pip install --system ruff mypy
+
+      - name: Run ruff format check
+        run: ruff format --check .
+
+      - name: Run ruff linter
+        run: ruff check .
+
+      - name: Run type checking
+        run: mypy src/ --install-types --non-interactive || true
+
+  validate-structure:
+    name: Validate Package Structure
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Validate pyproject.toml
+        run: |
+          uv pip install --system toml
+          python -c "import toml; toml.load('pyproject.toml')"
+
+      - name: Check required files
+        run: |
+          test -f README.md || (echo "Missing README.md" && exit 1)
+          test -f LICENSE || (echo "Missing LICENSE" && exit 1)
+          test -f pyproject.toml || (echo "Missing pyproject.toml" && exit 1)
+          test -f src/__init__.py || (echo "Missing src/__init__.py" && exit 1)
+          test -f src/server.py || (echo "Missing src/server.py" && exit 1)
+
+      - name: Test package build
+        run: |
+          uv build
+          ls -lh dist/
+
+  test-install:
+    name: Test Installation
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12']
+
+    steps:
+      - name: Checkout code
+        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@v4
+
+      - name: Install package
+        run: |
+          uv pip install --system .
+
+      - name: Verify installation
+        run: |
+          python -c "import src; print(f'Version: {src.__version__}')"
+          python -c "from src.config import get_settings; print('Config module OK')"
+          python -c "from src.services import ImageService; print('Services module OK')"
+          python -c "from src.tools import generate_image_tool; print('Tools module OK')"

ultimate_gemini_mcp-1.0.1/.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# uv
+.uv/
+uv.lock
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Generated images
+generated_images/
+*.png
+*.jpg
+*.jpeg
+*.webp
+
+# Logs
+*.log
+logs/
+
+# FastMCP
+.fastmcp/