blackbird-mcp-server

blackbirdai-team/blackbird-mcp-server

3.2

If you are the rightful owner of blackbird-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Blackbird MCP Server is a robust solution designed to integrate with the Blackbird AI platform, providing seamless connectivity and enhanced functionality for model context protocol operations.

Blackbird MCP Server

Prerequisites

Before you begin, ensure you have:

  • Blackbird API Credentials
    • You will need either:
      • BLACKBIRD_USERNAME and BLACKBIRD_PASSWORD
      • BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY
  • Claude Desktop or Cursor
  • uv
    • You can verify your uv installation by running:
      • uv --version
  • Git installed (only needed if using Git installation method)
    • On macOS: brew install git
    • On Linux:
      • Debian/Ubuntu: sudo apt install git
      • RedHat/CentOS: sudo yum install git
    • On Windows: Download Git for Windows

Blackbird MCP server installation

Configuring the Claude Desktop app

  1. Clone the repository
git clone https://github.com/blackbirdai-team/blackbird-mcp-server.git
cd blackbird-mcp-server
  1. Configure claude_desktop_config.json

For 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"

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the Blackbird server configuration:

Replace <PATH-TO-REPO> with the path where you cloned the repository. Replace the *** with your actual Blackbird credentials. Note: you only need BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY, or BLACKBIRD_USERNAME and 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": "***"
      }
    }
  }
}

Configuring Cursor

Note: Requires Cursor version 0.45.6 or higher

To set up the Blckbird MCP server in Cursor:

  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click on the "+ Add New MCP Server" button
  4. Fill out mcp.json the same way as you would for Claude Desktop
{
  "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": "***"
      }
    }
  }
}