starbridge


Namestarbridge JSON
Version 0.0.54 PyPI version JSON
download
home_pageNone
SummaryIntegrates Claude Desktop with Google workspace and Atlassian workspaces
upload_time2024-12-28 20:01:52
maintainerNone
docs_urlNone
authorNone
requires_python<4.0,>=3.11
licenseMIT License Copyright (c) [2024] [Helmut Hoffer von Ankershoffen (helmuthva@googlemail.com)] 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.
keywords anthropic atlassian bump-my-version claude codecov confluence cyclonedx devcontainer docker docker-compose git-cliff gitbook github-actions google-drive jira logfire mcp nox opentelemetry pre-commit pydantic pytest pytest-asyncio pytest-cov pytest-docker pytest-env pytest-xdist renovate ruff sonarqube typer uv
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # [PRE-ALPHA] starbridge MCP server for Claude Desktop

[![License](https://img.shields.io/github/license/helmut-hoffer-von-ankershoffen/starbridge?logo=opensourceinitiative&logoColor=3DA639&labelColor=414042&color=A41831)
](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/LICENSE)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/starbridge.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
[![CI](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/actions/workflows/test-and-report.yml)
[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[![Security](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)
[![Coverage](https://codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge/graph/badge.svg?token=SX34YRP30E)](https://codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge)
[![Ruff](https://img.shields.io/badge/style-Ruff-blue?color=D6FF65)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)
[![GitHub - Version](https://img.shields.io/github/v/release/helmut-hoffer-von-ankershoffen/starbridge?label=GitHub&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/releases)
![GitHub - Commits](https://img.shields.io/github/commit-activity/m/helmut-hoffer-von-ankershoffen/starbridge/main?label=commits&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)
[![PyPI - Version](https://img.shields.io/pypi/v/starbridge.svg?label=PyPI&logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/starbridge)
[![PyPI - Status](https://img.shields.io/pypi/status/starbridge?logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/starbridge)
[![Docker - Version](https://img.shields.io/docker/v/helmuthva/starbridge?sort=semver&label=Docker&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/starbridge/tags)
[![Docker - Size](https://img.shields.io/docker/image-size/helmuthva/starbridge?sort=semver&arch=arm64&label=image&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/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.

Integrates Claude Desktop with the WWW, Atlassian Confluence, and (later on) Google Workspace.

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

```uvx starbridge install``` - that's all.

Prequisites:
- You are running Mac OS X
- You already have the uv package manager installed
- You already have Claude Desktop for Mac OS X installed
- You don't care for the imaging extra

If you (possibly) need to install homebrew, uv, and care for all extras:

```shell
if [[ "$OSTYPE" == "darwin"* ]]; then # Install dependencies for macOS X
  if ! command -v brew &> /dev/null; then # Install Homebrew if not present
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  fi
  brew install cairo
elif [[ "$OSTYPE" == "linux-gnu"* ]]; then # Install dependencies for Linux
  sudo apt-get update -y && sudo apt-get install curl libcairo2 -y
fi
if ! command -v uvx &> /dev/null; then # Install uv package manager if not present
  curl -LsSf https://astral.sh/uv/install.sh | sh
  source $HOME/.local/bin/env
fi
uvx --with "starbridge[imaging]" starbridge install # Install starbridge, including configuration and injection into Claude Desktop App
```

Starbridge can be [run within Docker](DOCKER.md).

## MCP Server

Starbridge implements the [MCP Server](https://modelcontextprotocol.io/docs/concepts/architecture) 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]

## Contributing

Please read our [Contributing Guidelines](CONTRIBUTING.md) for how to setup for development, and before making a pull request.

## Resources

* [MCP Press release](https://www.anthropic.com/news/model-context-protocol)
* [MCP Specification and SDKs](https://github.com/modelcontextprotocol)
* [MCP Info to amend Claude's context](https://modelcontextprotocol.io/llms-full.txt)
* [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)

## Star History

<a href="https://star-history.com/#helmut-hoffer-von-ankershoffen/starbridge&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date" />
 </picture>
</a>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "starbridge",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.11",
    "maintainer_email": null,
    "keywords": "anthropic, atlassian, bump-my-version, claude, codecov, confluence, cyclonedx, devcontainer, docker, docker-compose, git-cliff, gitbook, github-actions, google-drive, jira, logfire, mcp, nox, opentelemetry, pre-commit, pydantic, pytest, pytest-asyncio, pytest-cov, pytest-docker, pytest-env, pytest-xdist, renovate, ruff, sonarqube, typer, uv",
    "author": null,
    "author_email": "Helmut Hoffer von Ankershoffen <helmuthva@googlemail.com>",
    "download_url": "https://files.pythonhosted.org/packages/fa/a7/f5caa75625eb312b795943cbfb6e47dbcf8651378da88e529a6f350fb40d/starbridge-0.0.54.tar.gz",
    "platform": null,
    "description": "# [PRE-ALPHA] starbridge MCP server for Claude Desktop\n\n[![License](https://img.shields.io/github/license/helmut-hoffer-von-ankershoffen/starbridge?logo=opensourceinitiative&logoColor=3DA639&labelColor=414042&color=A41831)\n](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/LICENSE)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/starbridge.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)\n[![CI](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/actions/workflows/test-and-report.yml)\n[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)\n[![Security](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)\n[![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_starbridge&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_starbridge)\n[![Coverage](https://codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge/graph/badge.svg?token=SX34YRP30E)](https://codecov.io/gh/helmut-hoffer-von-ankershoffen/starbridge)\n[![Ruff](https://img.shields.io/badge/style-Ruff-blue?color=D6FF65)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/blob/main/noxfile.py)\n[![GitHub - Version](https://img.shields.io/github/v/release/helmut-hoffer-von-ankershoffen/starbridge?label=GitHub&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)](https://github.com/helmut-hoffer-von-ankershoffen/starbridge/releases)\n![GitHub - Commits](https://img.shields.io/github/commit-activity/m/helmut-hoffer-von-ankershoffen/starbridge/main?label=commits&style=flat&labelColor=1C2C2E&color=blue&logo=GitHub&logoColor=white)\n[![PyPI - Version](https://img.shields.io/pypi/v/starbridge.svg?label=PyPI&logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/starbridge)\n[![PyPI - Status](https://img.shields.io/pypi/status/starbridge?logo=pypi&logoColor=%23FFD243&labelColor=%230073B7&color=FDFDFD)](https://pypi.python.org/pypi/starbridge)\n[![Docker - Version](https://img.shields.io/docker/v/helmuthva/starbridge?sort=semver&label=Docker&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/starbridge/tags)\n[![Docker - Size](https://img.shields.io/docker/image-size/helmuthva/starbridge?sort=semver&arch=arm64&label=image&logo=docker&logoColor=white&labelColor=1354D4&color=10151B)](https://hub.docker.com/r/helmuthva/starbridge/)\n\n\n> \u26a0\ufe0f **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.\n\nIntegrates Claude Desktop with the WWW, Atlassian Confluence, and (later on) Google Workspace.\n\n1. **Make Claude a team member**: Makes Claude an informed member of your organisation by accessing your organization's key knowledge resources.\n2. **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.\n3. **Improve efficiency**: Automate repetitive workflows such as generating Confluence pages from Google Docs.\n\n## Example Prompts\n\n* \"Create a page about road cycling, focusing on Canyon bikes, in the personal confluence space of Helmut.\"\n\n## Setup\n\n```uvx starbridge install``` - that's all.\n\nPrequisites:\n- You are running Mac OS X\n- You already have the uv package manager installed\n- You already have Claude Desktop for Mac OS X installed\n- You don't care for the imaging extra\n\nIf you (possibly) need to install homebrew, uv, and care for all extras:\n\n```shell\nif [[ \"$OSTYPE\" == \"darwin\"* ]]; then # Install dependencies for macOS X\n  if ! command -v brew &> /dev/null; then # Install Homebrew if not present\n    /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n  fi\n  brew install cairo\nelif [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then # Install dependencies for Linux\n  sudo apt-get update -y && sudo apt-get install curl libcairo2 -y\nfi\nif ! command -v uvx &> /dev/null; then # Install uv package manager if not present\n  curl -LsSf https://astral.sh/uv/install.sh | sh\n  source $HOME/.local/bin/env\nfi\nuvx --with \"starbridge[imaging]\" starbridge install # Install starbridge, including configuration and injection into Claude Desktop App\n```\n\nStarbridge can be [run within Docker](DOCKER.md).\n\n## MCP Server\n\nStarbridge implements the [MCP Server](https://modelcontextprotocol.io/docs/concepts/architecture) interface, with Claude acting as an MCP client.\n\n### Resources\n\n[TODO: Document resources exposed to Claude Desktop]\n\n### Prompts\n\n[TODO: Document prompts exposed to Claude Desktop]\n\n### Tools\n\n[TODO: Document tools exposed to Claude Desktop]\n\n## CLI\n\n[TODO: Document CLI commands]\n\n## Contributing\n\nPlease read our [Contributing Guidelines](CONTRIBUTING.md) for how to setup for development, and before making a pull request.\n\n## Resources\n\n* [MCP Press release](https://www.anthropic.com/news/model-context-protocol)\n* [MCP Specification and SDKs](https://github.com/modelcontextprotocol)\n* [MCP Info to amend Claude's context](https://modelcontextprotocol.io/llms-full.txt)\n* [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)\n\n## Star History\n\n<a href=\"https://star-history.com/#helmut-hoffer-von-ankershoffen/starbridge&Date\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=helmut-hoffer-von-ankershoffen/starbridge&type=Date\" />\n </picture>\n</a>\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) [2024] [Helmut Hoffer von Ankershoffen (helmuthva@googlemail.com)]  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.",
    "summary": "Integrates Claude Desktop with Google workspace and Atlassian workspaces",
    "version": "0.0.54",
    "project_urls": {
        "Changelog": "https://github.com/helmut-hoffer-von-ankershoffen/starbridge/releases",
        "Documentation": "https://helmuthva.gitbook.io/starbridge",
        "Homepage": "https://helmuthva.gitbook.io/starbridge",
        "Issues": "https://github.com/helmut-hoffer-von-ankershoffen/starbridge/issues",
        "Source": "https://github.com/helmut-hoffer-von-ankershoffen/starbridge"
    },
    "split_keywords": [
        "anthropic",
        " atlassian",
        " bump-my-version",
        " claude",
        " codecov",
        " confluence",
        " cyclonedx",
        " devcontainer",
        " docker",
        " docker-compose",
        " git-cliff",
        " gitbook",
        " github-actions",
        " google-drive",
        " jira",
        " logfire",
        " mcp",
        " nox",
        " opentelemetry",
        " pre-commit",
        " pydantic",
        " pytest",
        " pytest-asyncio",
        " pytest-cov",
        " pytest-docker",
        " pytest-env",
        " pytest-xdist",
        " renovate",
        " ruff",
        " sonarqube",
        " typer",
        " uv"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5c358f38f6690fded310c88218634c1be2dc8e2a42dbd8d37383852a832419b2",
                "md5": "ee191d4e72ca465b858d3cecd8ecb654",
                "sha256": "2fb4d181926c51cbcb7f764ab9ea65626af2f62154a7789e617ef27143dcb28c"
            },
            "downloads": -1,
            "filename": "starbridge-0.0.54-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ee191d4e72ca465b858d3cecd8ecb654",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.11",
            "size": 53521,
            "upload_time": "2024-12-28T20:01:49",
            "upload_time_iso_8601": "2024-12-28T20:01:49.490925Z",
            "url": "https://files.pythonhosted.org/packages/5c/35/8f38f6690fded310c88218634c1be2dc8e2a42dbd8d37383852a832419b2/starbridge-0.0.54-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "faa7f5caa75625eb312b795943cbfb6e47dbcf8651378da88e529a6f350fb40d",
                "md5": "3374e9f896e6022898ca6bd8c655cdb1",
                "sha256": "2fd4924b1cca0d81bdc2d3537df0cec9f9fa4f54651c6432ae4d48c2fa0f5f44"
            },
            "downloads": -1,
            "filename": "starbridge-0.0.54.tar.gz",
            "has_sig": false,
            "md5_digest": "3374e9f896e6022898ca6bd8c655cdb1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.11",
            "size": 13704730,
            "upload_time": "2024-12-28T20:01:52",
            "upload_time_iso_8601": "2024-12-28T20:01:52.348979Z",
            "url": "https://files.pythonhosted.org/packages/fa/a7/f5caa75625eb312b795943cbfb6e47dbcf8651378da88e529a6f350fb40d/starbridge-0.0.54.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-28 20:01:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "helmut-hoffer-von-ankershoffen",
    "github_project": "starbridge",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "starbridge"
}
        
Elapsed time: 0.68678s