# Contributing to Ghost-MCP-Server
We welcome contributions to improve the Ghost MCP Server! Please follow these guidelines when contributing.
## Reporting Issues
If you encounter a bug or have a suggestion for improvement, please check the existing [Issues](https://github.com/jgardner04/Ghost-MCP-Server/issues) to see if a similar topic has already been reported. If not, please [open a new issue](https://github.com/jgardner04/Ghost-MCP-Server/issues/new).
When reporting a bug, please include:
- A clear and descriptive title.
- Steps to reproduce the issue.
- What you expected to happen.
- What actually happened.
- Your environment details (e.g., Node.js version, OS).
## Development Workflow
Before starting any work, always create a feature branch:
```bash
git checkout main
git pull origin main
git checkout -b <type>/issue-<number>-<description>
```
### Branch Naming Convention
| Prefix | Use Case | Example |
| ----------- | --------------------------------------------- | ------------------------------------ |
| `feature/` | New features | `feature/issue-42-add-pagination` |
| `fix/` | Bug fixes | `fix/issue-15-image-upload-error` |
| `docs/` | Documentation changes | `docs/update-api-reference` |
| `refactor/` | Code refactoring | `refactor/issue-30-simplify-auth` |
| `test/` | Test additions or fixes | `test/add-member-service-tests` |
**Important:** Never commit directly to `main`. All changes must go through pull requests.
## Submitting Pull Requests
1. **Fork the repository** and create your branch from `main`.
2. **Make your changes.** Ensure your code follows the existing style and conventions.
3. **Add tests** for any new features or bug fixes (if applicable).
4. **Ensure all tests pass.**
5. **Update documentation** if your changes affect usage or features.
6. **Submit a pull request** to the `main` branch of the original repository.
In your pull request description, please explain the changes you made and why.
Thank you for contributing!