Skip to content

Contributing

We welcome contributions! Currently, we're accepting bug fixes and security patches. For new features, please open an issue first to discuss.

Development Setup

  1. Ensure you have Swift 6.2+ installed
  2. Clone the repo: git clone https://github.com/harpertoken/mcp-org.git
  3. Build: swift build
  4. Test: swift run MCPGitHubOrgMapper

Making Changes

  1. Fork and create a branch
  2. Write tests for your changes
  3. Ensure swift build and swift run work
  4. Update README/docs if needed
  5. Submit PR with clear description

Coding Standards

  • Use Swift conventions
  • Add comments for complex logic
  • Keep security in mind (no secrets in code)
  • Run tests before submitting

Reporting Bugs

  • Check existing issues first
  • Provide steps to reproduce
  • Include Swift version and macOS version