⭐ Starbridge

Warning

This project is currently in pre-alpha phase, i.e. partly functional. Feel free to already watch or star the repository to stay updated on its progress.

Tip

📚 Online documentation - 📖 PDF Manual

Note

🧠 This project was scaffolded using the template oe-python-template with copier.

---

Integrates Claude Desktop with the web, Google and Atlassian workspaces.

1. Make Claude a team member: Makes Claude an informed member of your organisation by accessing your organization's key knowledge resources.
2. Integrate research and knowlege management: Enables your teams to contribute, refine, and maintain your organisation's knowledge resources within Claude - seamlessly integrating research and sharing knowledge.
3. Improve efficiency: Automate repetitive workflows such as generating Confluence pages from Google Docs.

Example Prompts

• "Create a page about road cycling, focusing on Canyon bikes, in the personal confluence space of Helmut."

Setup

If you already have uv package manager and Claude Desktop installed on your Mac:

# Installs starbridge in an isolated Python environment
# Auto-injects configuration into Claude Desktop
uvx starbridge install

If you first need to install uv:

if ! command -v brew &> /dev/null; then # Install Homebrew
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
fi
brew install uv # Install uv via Homebrew
uvx starbridge install # Install starbridge via uv

If you want to install starbridge with the imaging extra

uvx --with "starbridge[imaging]" starbridge install

You can as well run Starbridge with Docker.

MCP Server

Starbridge implements the MCP Server interface, with Claude acting as an MCP client.

Resources

[TODO: Document resources exposed to Claude Desktop]

Prompts

[TODO: Document prompts exposed to Claude Desktop]

Tools

[TODO: Document tools exposed to Claude Desktop]

CLI

[TODO: Document CLI commands]

Operational Excellence

This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:

1. Complete reference documentation of the CLI and of the library on Read the Docs
2. Transparent test coverage including unit and E2E tests (reported on Codecov)
3. Matrix tested with multiple python versions to ensure compatibility (powered by Nox)
4. Compliant with modern linting and formatting standards (powered by Ruff)
5. Up-to-date dependencies (monitored by Renovate and Dependabot)
6. A-grade code quality in security, maintainability, and reliability with low technical debt and codesmell (verified by SonarQube)
7. Additional code security checks using CodeQL
8. Security Policy
9. License compliant with the Open Source Initiative (OSI)
10. 1-liner for installation and execution of command line interface (CLI) via uv(x) or Docker
11. Setup for developing inside a devcontainer included (supports VSCode and GitHub Codespaces)

Further Reading

• Inspect our security policy with detailed documentation of checks, tools and principles.
• Check out the CLI Reference with detailed documentation of all CLI commands and options.
• Check out the Library Reference with detailed documentation of public classes and functions.
• Our release notes provide a complete log of recent improvements and changes.
• In case you want to help us improve ⭐ Starbridge: The contribution guidelines explain how to setup your development environment and create pull requests.
• We gratefully acknowledge the open source projects that this project builds upon. Thank you to all these wonderful contributors!

Star History