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 で Blackbird MCP サーバーをセットアップするには：

1. Cursor の設定を開きます
2. 機能 > MCP サーバーに移動します
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": "***"
      }
    }
  }
}