sitebay-mcp 0.1.1751179164__tar.gz

sitebay_mcp-0.1.1751179164/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 120
+ignore = E203, E111, E117, E261, E225, F841, F811, F824, F821

sitebay_mcp-0.1.1751179164/.github/workflows/python-pytest.yml

@@ -0,0 +1,39 @@
+name: Python Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      # Checkout the repository
+      - uses: actions/checkout@v4
+
+      # Set up Python environment
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.12'
+
+      # Install uv
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      # Set up Python environment with uv
+      - name: Set up Python
+        run: uv python install
+
+      # Sync dependencies with uv
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      # Run tests
+      - name: Run tests
+        run: uv run pytest tests/unit
+        env:
+          PYTHONPATH: ${{ github.workspace }}

sitebay_mcp-0.1.1751179164/.github/workflows/testpypi.yaml

@@ -0,0 +1,52 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [ "main" ]
+  release:
+    types: [ published ]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/sitebay-mcp/
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.11"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build wheel twine setuptools
+
+    - name: Bump version automatically
+      run: |
+        NEW_VERSION=$(python -c "import time; print('0.1.' + str(int(time.time())))")
+        echo "Updating version to $NEW_VERSION"
+        sed -i "s/^version = .*/version = \"$NEW_VERSION\"/" pyproject.toml
+
+    - name: Build package artifacts
+      run: python -m build
+
+    - name: Validate package structure
+      run: twine check dist/*
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://upload.pypi.org/legacy/
+        password: ${{ secrets.PYPI_API_TOKEN }}
+        attestations: false
+        twine-args: --verbose

sitebay_mcp-0.1.1751179164/.gitignore

@@ -0,0 +1,174 @@
+# 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
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# PyPI configuration file
+.pypirc
+
+*.bak
+*.swp

sitebay_mcp-0.1.1751179164/Dockerfile

@@ -0,0 +1,8 @@
+# Generated by https://smithery.ai. See: https://smithery.ai/docs/build/project-config
+FROM python:3.10-slim
+
+WORKDIR /app
+COPY . /app
+RUN pip install --no-cache-dir .
+
+CMD ["sitebay-mcp"]

sitebay_mcp-0.1.1751179164/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mhand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sitebay_mcp-0.1.1751179164/PKG-INFO

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: sitebay-mcp
+Version: 0.1.1751179164
+Summary: SiteBay MCP Server - WordPress hosting management through Claude Code
+Author-email: SiteBay <support@sitebay.org>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.9.2
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SiteBay MCP Server
+[![smithery badge](https://smithery.ai/badge/@sitebay/sitebay-mcp)](https://smithery.ai/server/@sitebay/sitebay-mcp)
+
+A Model Context Protocol (MCP) server that provides Claude Code users with direct access to the SiteBay WordPress hosting platform. Manage your hosted WordPress sites, execute server commands, handle staging environments, and more through natural language interactions with the SiteBay cloud infrastructure.
+
+## Features
+
+### 🌐 Site Management
+- List all your hosted WordPress sites
+- Get detailed site information (status, region, PHP version, etc.)
+- Create new WordPress sites using SiteBay's templates
+- Update site configurations (PHP version, admin credentials, etc.)
+- Delete sites with safety confirmations
+
+### ⚡ Site Operations
+- Execute shell commands and WP-CLI commands on SiteBay servers
+- Edit files in wp-content directory on your hosted sites
+- View site events and deployment logs from SiteBay infrastructure  
+- Manage external path configurations for URL proxying through SiteBay
+
+### 🛠 Advanced Features
+- Staging site management on SiteBay infrastructure (coming soon)
+- Point-in-time backup restores from SiteBay's backup system (coming soon)
+- Team management for collaborative hosting (coming soon)
+- WordPress/Shopify/PostHog API proxy services through SiteBay (coming soon)
+
+### 🗺 Helper Tools
+- List available SiteBay hosting regions
+- Browse SiteBay's WordPress templates
+- Account and billing information (coming soon)
+
+## Installation
+
+### Installing via Smithery
+
+To install SiteBay MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@sitebay/sitebay-mcp):
+
+```bash
+npx -y @smithery/cli install @sitebay/sitebay-mcp --client claude
+```
+
+### Using uvx (Recommended)
+
+```bash
+# Install and run directly with uvx
+uvx sitebay-mcp
+
+# Or install for repeated use
+uv tool install sitebay-mcp
+sitebay-mcp
+```
+
+### Using pip
+
+```bash
+# Install from PyPI (when published)
+pip install sitebay-mcp
+
+# Or install from source
+git clone https://github.com/your-username/sitebay-mcp.git
+cd sitebay-mcp
+pip install -e .
+```
+
+## Configuration
+
+### 1. Get Your SiteBay API Token
+
+1. Log in to your [SiteBay account](https://my.sitebay.org)
+2. Navigate to Settings in your account dashboard
+3. Generate a new API token
+4. Copy the token for use in configuration
+
+### 2. Configure Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+#### For uvx installation:
+```json
+{
+  "mcpServers": {
+    "sitebay": {
+      "command": "uvx",
+      "args": ["sitebay-mcp"],
+      "env": {
+        "SITEBAY_API_TOKEN": "your_api_token_here"
+      }
+    }
+  }
+}
+```
+
+#### For pip installation:
+```json
+{
+  "mcpServers": {
+    "sitebay": {
+      "command": "python",
+      "args": ["-m", "sitebay_mcp.server"],
+      "env": {
+        "SITEBAY_API_TOKEN": "your_api_token_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Claude Desktop Configuration File Locations
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
+- **Linux**: `~/.config/claude/claude_desktop_config.json`
+
+## Usage Examples
+
+### Creating a New WordPress Site
+
+```
+Claude: Create a new WordPress site called "myblog.example.com" with the title "My Amazing Blog", admin username "admin", password "SecurePass123!", and email "me@example.com"
+```
+
+### Managing Existing Sites
+
+```
+Claude: List all my WordPress sites and show their current status
+
+Claude: Get detailed information about myblog.example.com
+
+Claude: Update the PHP version for myblog.example.com to 8.2
+```
+
+### Executing Commands
+
+```
+Claude: Run "wp plugin list" on myblog.example.com to see what plugins are installed on the SiteBay server
+
+Claude: Execute "wp search-replace 'http://old-domain.com' 'https://new-domain.com'" on myblog.example.com through SiteBay
+
+Claude: Check the disk usage on myblog.example.com with "df -h" on the SiteBay server
+```
+
+### File Management
+
+```
+Claude: Edit the style.css file in my active theme on myblog.example.com hosted on SiteBay
+
+Claude: Show me recent events and deployment logs for myblog.example.com from SiteBay
+```
+
+### External Paths (URL Proxying)
+
+```
+Claude: Create an external path "/api" on myblog.example.com that proxies to "https://my-external-api.com" through SiteBay
+
+Claude: List all external path configurations for myblog.example.com on SiteBay
+```
+
+### Getting Information
+
+```
+Claude: Show me all available SiteBay hosting regions
+
+Claude: List all the WordPress templates available on SiteBay for new sites
+```
+
+## Available Tools
+
+### Site Management
+- `sitebay_list_sites` - List all WordPress sites hosted on SiteBay
+- `sitebay_get_site` - Get detailed information about a hosted site
+- `sitebay_create_site` - Create a new WordPress site on SiteBay infrastructure
+- `sitebay_update_site` - Update site configuration on SiteBay servers
+- `sitebay_delete_site` - Delete a hosted site (with confirmation)
+
+### Site Operations
+- `sitebay_site_shell_command` - Execute shell/WP-CLI commands on SiteBay servers
+- `sitebay_site_edit_file` - Edit files in wp-content on SiteBay-hosted sites
+- `sitebay_site_get_events` - View site events and deployment logs from SiteBay
+- `sitebay_site_external_path_list` - List external path configs on SiteBay
+- `sitebay_site_external_path_create` - Create external path through SiteBay proxy
+
+### Helper Tools
+- `sitebay_list_regions` - List available SiteBay hosting regions
+- `sitebay_list_templates` - List WordPress templates available on SiteBay
+
+## Security Notes
+
+- Your SiteBay API token is stored securely in environment variables
+- All communications with SiteBay infrastructure use HTTPS encryption
+- API tokens can be revoked at any time from your SiteBay account dashboard
+- The MCP server runs locally and only proxies requests to SiteBay - no data is stored locally
+
+## Error Handling
+
+The server provides clear error messages for common issues:
+
+- **Authentication errors**: Invalid or expired API tokens
+- **Site not found**: When referencing non-existent sites
+- **Validation errors**: Invalid parameters or missing required fields
+- **Network errors**: Connection issues with SiteBay API
+
+## Troubleshooting
+
+### Authentication Issues
+
+1. Verify your API token is correct
+2. Check that the token is properly set in the environment variable
+3. Ensure the token hasn't expired
+4. Try regenerating the token from your SiteBay account
+
+### Connection Issues
+
+1. Check your internet connection
+2. Verify SiteBay service status
+3. Check firewall settings
+4. Try restarting Claude Desktop
+
+### Tool Not Found
+
+1. Restart Claude Desktop after configuration changes
+2. Verify the configuration file is in the correct location
+3. Check the JSON syntax is valid
+4. Ensure uvx or Python is properly installed
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass and code is properly formatted
+6. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Support
+
+- **Issues**: GitHub Issues
+- **Documentation**: [SiteBay API Docs](https://my.sitebay.org/f/api/v1/docs)
+- **SiteBay Support**: [SiteBay Help Center](https://sitebay.org/support)
+
+## Changelog
+
+### v0.1.0 (2024-01-XX)
+- Initial release
+- Site management tools
+- Shell command execution
+- File editing capabilities
+- External path management
+- Region and template listing