使用说明

项目简介

Starbridge 是一个基于 Model Context Protocol (MCP) 构建的服务器，它作为 Claude 桌面应用的后端，扩展了 Claude 的能力，使其能够访问和利用 Web、Google 以及 Atlassian 工作区的数据和功能。通过 Starbridge，Claude 不再是一个孤立的应用，而可以成为连接各种信息源和自动化工作流的智能助手。

主要功能点

资源 (Resources) 管理: 托管和管理来自 Confluence 空间和 Web 页面的知识资源，使得 Claude 可以访问和利用这些信息。
工具 (Tools) 注册与执行: 提供了一系列工具，例如：
- Confluence 工具: 用于在 Confluence 中创建、读取、更新、删除页面，以及列出空间和搜索页面。
- Web 工具: 用于从 Web 获取内容，支持 HTML 到 Markdown 转换和链接提取。
- 搜索工具: 利用 Brave Search API 进行 Web 搜索。
- 示例工具: 提供 Hello World 示例工具，用于演示 MCP 服务器的功能。
Prompt 模板 (Prompts): 定义了 Prompt 模板，例如 Confluence 空间摘要，允许用户以结构化的方式与 Claude 进行交互，获取特定格式的响应。
集成 Claude 桌面应用: 通过 MCP 协议与 Claude 桌面应用通信，实现功能的集成和扩展。
多种传输协议支持: 支持 Stdio 和 SSE 传输协议，保证了与 MCP 客户端通信的灵活性和可靠性。

安装步骤

环境准备: 确保已安装 macOS 并已安装 Claude 桌面应用。

安装 uvx: 如果尚未安装 'uvx' 包管理器，请执行以下命令安装：

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

安装 Starbridge: 运行以下命令即可完成 Starbridge 的安装，包括配置和注入到 Claude 桌面应用中：

uvx starbridge install

如果需要安装包含图像处理等额外功能的版本，可以使用以下命令：

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

服务器配置

对于 MCP 客户端（如 Claude 桌面应用）而言，配置 Starbridge MCP 服务器需要提供服务器的启动命令及其参数。以下是根据 Starbridge 仓库信息生成的 JSON 格式配置信息示例：

使用 'uvx' 启动 (开发环境或已安装 uvx 的环境):

{
  "starbridge": {
    "serverName": "starbridge",
    "command": "uvx",
    "args": [
      "starbridge"
    ],
    "env": {
      "STARBRIDGE_ATLASSIAN_URL": "您的Atlassian URL (例如: https://your-domain.atlassian.net)",
      "STARBRIDGE_ATLASSIAN_EMAIL_ADDRESS": "您的Atlassian邮箱地址",
      "STARBRIDGE_ATLASSIAN_API_TOKEN": "您的Atlassian API Token (请前往 https://id.atlassian.com/manage-profile/security/api-tokens 创建)",
      "STARBRIDGE_LOGFIRE_TOKEN": "您的Logfire Token (可选，用于日志监控)",
      "STARBRIDGE_LOGFIRE_ENVIRONMENT": "Logfire 环境 (例如: production, development，可选)",
      "STARBRIDGE_SEARCH_BRAVE_SEARCH_API_KEY": "Brave Search API 密钥 (请前往 https://brave.com/search/api/ 申请)",
      "STARBRIDGE_LOGGING_LOGLEVEL": "日志级别 (例如: DEBUG, INFO, WARNING, ERROR, CRITICAL，可选，默认为 INFO)"
      // ... 其他可选环境变量配置 ...
    }
  }
}

使用 Docker 启动 (容器环境):

{
  "starbridge": {
    "serverName": "starbridge",
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e", "STARBRIDGE_ATLASSIAN_URL=您的Atlassian URL (例如: https://your-domain.atlassian.net)",
      "-e", "STARBRIDGE_ATLASSIAN_EMAIL_ADDRESS=您的Atlassian邮箱地址",
      "-e", "STARBRIDGE_ATLASSIAN_API_TOKEN=您的Atlassian API Token",
      "-e", "STARBRIDGE_LOGFIRE_TOKEN=您的Logfire Token",
      "-e", "STARBRIDGE_LOGFIRE_ENVIRONMENT=production",
      "-e", "STARBRIDGE_SEARCH_BRAVE_SEARCH_API_KEY=您的Brave Search API 密钥",
      "-e", "STARBRIDGE_LOGGING_LOGLEVEL=INFO",
      "helmuthva/starbridge:latest"
    ],
    "env": {} // 容器环境中环境变量通过 args 传递
  }
}

注意:

请将 '您的Atlassian URL'、'您的Atlassian邮箱地址'、'您的Atlassian API Token'、'您的Logfire Token'、'您的Brave Search API 密钥' 替换为您的实际信息。
环境变量 'env' 部分可以根据需要配置，例如设置 Atlassian 和 Brave Search API 的密钥等。

基本使用方法

启动 Starbridge 服务器: 安装完成后，Starbridge 会自动配置并尝试注入到 Claude 桌面应用。如果选择手动配置，可以根据上述“服务器配置”部分的信息，在 MCP 客户端中配置 Starbridge 服务器连接。
在 Claude 中使用: 配置完成后，在 Claude 桌面应用中，您应该能够使用 Starbridge 提供的功能，例如：
- 让 Claude 访问 Confluence 空间和页面内容，以便 Claude 可以基于这些知识进行对话和回答问题。
- 调用 Starbridge 提供的工具，例如让 Claude 搜索 Web 信息或在 Confluence 中创建页面。
- 使用预定义的 Prompt 模板，例如要求 Claude 总结 Confluence 空间的内容。

具体使用方式取决于 Claude 桌面应用如何集成和调用 MCP 服务器提供的功能。请参考 Claude 桌面应用和 Starbridge 的文档以获取更详细的使用指南。

关键词