关键词

LLM扩展功能上下文管理Blackbird AI集成Claude DesktopCursor

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器端实现，用于连接 Blackbird AI 服务与支持 MCP 协议的 LLM 客户端（例如 Claude Desktop, Cursor）。

项目简介

Blackbird MCP 服务器作为 Blackbird AI 和 LLM 客户端之间的桥梁，允许 LLM 访问 Blackbird AI 平台提供的数据、工具或特定上下文信息，从而增强 LLM 的能力和交互体验。

主要功能点

  • 实现 Model Context Protocol (MCP) 的部分或全部功能，以便与兼容的 LLM 客户端通信。
  • 将 Blackbird AI 的能力（如数据访问、特定分析功能等）通过标准的 MCP 接口暴露给 LLM。
  • 支持由 MCP 客户端启动和管理服务器进程。

安装步骤

  1. 前置条件: 确保您的系统已安装 Git 和 uv (一个 Python 包管理器和执行器)。您还需要有效的 Blackbird API 凭证（密钥对或用户名密码）。
  2. 克隆仓库: 打开终端或命令提示符，运行以下命令克隆项目仓库： 
    git clone https://github.com/blackbirdai-team/blackbird-mcp-server.git
  3. 进入目录: 切换到克隆下来的仓库目录： 
    cd blackbird-mcp-server

服务器配置 (为MCP客户端配置)

MCP 服务器通常由 MCP 客户端启动和管理。您需要在您的 MCP 客户端（如 Claude Desktop 或 Cursor）中添加配置，告诉客户端如何启动和连接 Blackbird MCP 服务器。配置信息通常是 JSON 格式，指定服务器的启动命令、参数和必要的环境变量。

以下是配置示例（具体配置方法请参考您的 MCP 客户端文档）：

  • 服务器名称: 'blackbird-mcp-server' (这是客户端引用此服务器时使用的唯一名称)
  • 启动命令 (command): 'uv'
  • 启动参数 (args):
    • 'run'
    • '--with'
    • 'mcp[cli]' (指定运行环境依赖)
    • '--with'
    • 'backoff' (指定运行环境依赖)
    • 'mcp' (MCP 框架的执行命令)
    • 'run'
    • '<PATH-TO-REPO>/blackbird-mcp-server/server.py' (指向您本地克隆仓库中的 'server.py' 文件路径)
  • 环境变量 (env): 用于传递 Blackbird AI 凭证。请根据您拥有的凭证类型配置以下一项或两项：
    • 'BLACKBIRD_CLIENT_KEY': 您的 Blackbird AI 客户端密钥
    • 'BLACKBIRD_SECRET_KEY': 您的 Blackbird AI 密钥
    • 'BLACKBIRD_USERNAME': 您的 Blackbird AI 用户名
    • 'BLACKBIRD_PASSWORD': 您的 Blackbird AI 密码

将这些信息填入您的 MCP 客户端的服务器配置界面或配置文件中。请确保将 '<PATH-TO-REPO>' 替换为您实际克隆 'blackbird-mcp-server' 仓库的完整路径。

基本使用方法

完成 MCP 客户端中的服务器配置后，启动或重启您的 MCP 客户端。客户端会根据配置自动启动 Blackbird MCP 服务器。一旦服务器成功启动并与客户端建立连接，LLM 应该能够利用 Blackbird MCP 服务器提供的上下文和功能。具体如何触发和使用这些功能取决于您的 MCP 客户端界面以及该服务器具体实现了哪些 MCP 能力（资源、工具、Prompt）。

信息

分类

AI与计算

访问项目