Blackbird MCP Server

Blackbird MCP 服务

前置条件

开始之前，请确保你具备：

• Blackbird API 凭据
  • 你需要以下任一组：
    • BLACKBIRD_USERNAME 和 BLACKBIRD_PASSWORD
    • BLACKBIRD_CLIENT_KEY 和 BLACKBIRD_SECRET_KEY
• Claude Desktop 或 Cursor
• uv
  • 运行以下命令，验证 uv 是否已安装：
    • uv --version
• 已安装 Git（仅在使用 Git 安装方式时需要）
  • 在 macOS 上：brew install git
  • 在 Linux 上：
    • Debian/Ubuntu：sudo apt install git
    • RedHat/CentOS：sudo yum install git
  • 在 Windows 上：下载 Git for Windows

安装 Blackbird MCP 服务

配置 Claude Desktop 应用

1. 克隆仓库

git clone https://github.com/blackbirdai-team/blackbird-mcp-server.git
cd blackbird-mcp-server

2. 配置 claude_desktop_config.json

macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加 Blackbird 服务配置：

将 <PATH-TO-REPO> 替换为克隆仓库的路径。 将 *** 替换为你的实际 Blackbird 凭据。注意：你只需要 BLACKBIRD_CLIENT_KEY 和 BLACKBIRD_SECRET_KEY，或 BLACKBIRD_USERNAME 和 BLACKBIRD_PASSWORD。

{
  "mcpServers": {
    "blackbird-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "backoff",
        "mcp",
        "run",
        "<PATH-TO-REPO>/blackbird-mcp-server/server.py"
      ],
      "env": {
        "BLACKBIRD_CLIENT_KEY": "***",
        "BLACKBIRD_SECRET_KEY": "***",
        "BLACKBIRD_USERNAME": "***",
        "BLACKBIRD_PASSWORD": "***"
      }
    }
  }
}

配置 Cursor

注意：需要 Cursor 0.45.6 或更高版本

在 Cursor 中设置 Blckbird MCP 服务：

1. 打开 Cursor 设置
2. 转到 Features > MCP Servers
3. 点击“+ Add New MCP Server”按钮
4. 按照为 Claude Desktop 配置的方式填写 mcp.json

{
  "mcpServers": {
    "blackbird-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "backoff",
        "mcp",
        "run",
        "<PATH-TO-REPO>/blackbird-mcp-server/server.py"
      ],
      "env": {
        "BLACKBIRD_CLIENT_KEY": "***",
        "BLACKBIRD_SECRET_KEY": "***",
        "BLACKBIRD_USERNAME": "***",
        "BLACKBIRD_PASSWORD": "***"
      }
    }
  }
}