feat: Initial commit

Author: CodeWithKyrian

.github/workflows/changelog.yml

@@ -0,0 +1,31 @@
+name: "Update Changelog"
+
+on:
+  release:
+    types: [released]
+
+permissions:
+  contents: write
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Update Changelog
+        uses: stefanzweifel/changelog-updater-action@v1
+        with:
+          latest-version: ${{ github.event.release.name }}
+          release-notes: ${{ github.event.release.body }}
+
+      - name: Commit updated CHANGELOG
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          branch: main
+          commit_message: Update CHANGELOG
+          file_pattern: CHANGELOG.md

.github/workflows/tests.yml

@@ -0,0 +1,39 @@
+name: tests
+
+on: ['push', 'pull_request']
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        php: [8.1, 8.2, 8.3, 8.4]
+      max-parallel: 4
+
+    name: Tests PHP${{ matrix.php }} - ${{ matrix.os }}
+
+    steps:
+
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.composer/cache/files
+          key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+
+      - name: Install Composer dependencies
+        run: composer update --no-interaction --prefer-dist
+
+      - name: Run Tests
+        run: composer test

.gitignore

@@ -0,0 +1,67 @@
+# Composer dependencies
+/vendor/
+/composer.lock
+
+# PHPUnit
+.phpunit.result.cache
+
+# PHP CS Fixer
+/.php-cs-fixer.cache
+/.php-cs-fixer.php
+
+# Editor directories and files
+/.idea
+/.vscode
+*.sublime-project
+*.sublime-workspace
+
+# Operating system files
+.DS_Store
+Thumbs.db
+
+# Local environment files
+/.env
+/.env.backup
+/.env.local
+
+# PHP CodeSniffer
+/.phpcs.xml
+/.phpcs.xml.dist
+/phpcs.xml
+/phpcs.xml.dist
+
+# PHPStan
+/phpstan.neon
+/phpstan.neon.dist
+
+# Local development tools
+/.php_cs
+/.php_cs.cache
+/.php_cs.dist
+/_ide_helper.php
+/.php-cs-fixer.php
+
+# Build artifacts
+/build/
+/coverage/
+
+# PHPUnit coverage reports
+/clover.xml
+/coverage.xml
+/coverage/
+
+# Laravel generated files
+bootstrap/cache/
+.phpunit.result.cache
+
+# Local Composer dependencies
+composer.phar
+
+workbench
+playground
+
+# Log files
+*.log
+
+# Cache files
+cache

CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+All notable changes to `php-mcp/client` will be documented in this file.

CONTRIBUTING.md

@@ -0,0 +1,59 @@
+# Contributing to php-mcp/client
+
+First off, thank you for considering contributing to `php-mcp/client`! We appreciate your time and effort. This project aims to provide a robust and easy-to-use PHP client for the Model Context Protocol.
+
+Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open-source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
+
+## How Can I Contribute?
+
+There are several ways you can contribute:
+
+*   **Reporting Bugs:** If you find a bug, please open an issue on the GitHub repository. Include steps to reproduce, expected behavior, and actual behavior. Specify your PHP version, operating system, and relevant package versions.
+*   **Suggesting Enhancements:** Open an issue to suggest new features or improvements to existing functionality. Explain the use case and why the enhancement would be valuable.
+*   **Improving Documentation:** If you find errors, omissions, or areas that could be clearer in the README or code comments, please submit a pull request or open an issue.
+*   **Writing Code:** Submit pull requests to fix bugs or add new features.
+
+## Development Setup
+
+1.  **Fork the repository:** Click the "Fork" button on the [php-mcp/client GitHub page](https://github.com/php-mcp/client).
+2.  **Clone your fork:** `git clone [email protected]:YOUR_USERNAME/client.git`
+3.  **Navigate into the directory:** `cd client`
+4.  **Install dependencies:** `composer install` (This installs runtime and development dependencies).
+
+## Submitting Changes (Pull Requests)
+
+1.  **Create a new branch:** `git checkout -b feature/your-feature-name` or `git checkout -b fix/issue-number`.
+2.  **Make your changes:** Write your code and accompanying tests.
+3.  **Ensure Code Style:** Run the code style fixer (if configured, e.g., PHP CS Fixer):
+    ```bash
+    composer lint # Or ./vendor/bin/php-cs-fixer fix
+    ```
+    Adhere to PSR-12 coding standards.
+4.  **Run Tests:** Ensure all tests pass:
+    ```bash
+    composer test # Or ./vendor/bin/pest
+    ```
+    Consider adding new tests for your changes. Aim for good test coverage.
+5.  **Update Documentation:** If your changes affect the public API or usage, update the `README.md` and relevant PHPDoc blocks.
+6.  **Commit your changes:** Use clear and descriptive commit messages. `git commit -m "feat: Add support for resource subscriptions"` or `git commit -m "fix: Correct handling of transport errors"`
+7.  **Push to your fork:** `git push origin feature/your-feature-name`
+8.  **Open a Pull Request:** Go to the original `php-mcp/client` repository on GitHub and open a pull request from your branch to the `main` branch (or the appropriate development branch).
+9.  **Describe your changes:** Provide a clear description of the problem and solution in the pull request. Link to any relevant issues (`Closes #123`).
+
+## Coding Standards
+
+*   Follow **PSR-12** coding standards.
+*   Use **strict types:** `declare(strict_types=1);` at the top of PHP files.
+*   Use **PHP 8.1+ features** where appropriate (readonly properties, enums, etc.).
+*   Add **PHPDoc blocks** for all public classes, methods, and properties.
+*   Write clear and concise code. Add comments only where necessary to explain complex logic.
+
+## Reporting Issues
+
+*   Use the GitHub issue tracker.
+*   Check if the issue already exists.
+*   Provide a clear title and description.
+*   Include steps to reproduce the issue, code examples, error messages, and stack traces if applicable.
+*   Specify relevant environment details (PHP version, OS, package version).
+
+Thank you for contributing!

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kyrian Obikwelu
+
+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.