What is Blackbird Mcp Server

The blackbird-mcp-server is a server designed to integrate with the Blackbird API, enabling users to leverage AI capabilities for various applications.

Use cases

Use cases include automating data processing tasks, enhancing user interactions in applications, and developing AI-driven solutions for businesses.

How to use

To use the blackbird-mcp-server, clone the repository from GitHub, configure the necessary credentials in the ‘claude_desktop_config.json’ file, and ensure all prerequisites are met before running the server.

Key features

Key features include seamless integration with Blackbird API, support for Claude Desktop and Cursor applications, and a straightforward installation process.

Where to use

The blackbird-mcp-server can be used in fields such as AI development, data analysis, and software integration where advanced AI functionalities are required.

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

2. 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": "***"
      }
    }
  }
}