Black SparrowBlack Sparrow

AI & Model Context Protocol (MCP)

Model Context Protocol (MCP) Setup

Connect Black Sparrow's native MCP server to Claude Desktop, Cursor, and Windsurf.

Black Sparrow features a native, pure-Rust Model Context Protocol (MCP) server over standard input/output (stdio).

This allows AI coding agents in Claude Desktop, Cursor, Windsurf, and Antigravity to run technical SEO audits, query issues, validate schemas, and fix bugs autonomously directly inside your codebase!

┌─────────────────────────┐          JSON-RPC 2.0 (stdio)         ┌─────────────────────────┐
│     AI Coding Agent     │ ◄───────────────────────────────────► │   Black Sparrow Engine  │
│ (Claude/Cursor/Windsurf)│       seo_start_audit, query, ...     │     (sparrow mcp)       │
└─────────────────────────┘                                       └─────────────────────────┘

1. Quick Prompt Setup

If your AI assistant supports adding MCP tools via natural language, simply tell your agent:

"Add a local MCP server named blacksparrow with the command blacksparrow and arguments ['mcp']."

2. Manual Configuration by Client

Open your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Add the blacksparrow server definition:

claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "blacksparrow": {
      "command": "blacksparrow",
      "args": ["mcp"]
    }
  }
}

Restart Claude Desktop. You will see a hammer icon indicating that Black Sparrow's 8 SEO tools are active!

Verifying the MCP Server

You can verify that the MCP server starts cleanly by running:

Terminal
Terminal
sparrow mcp

The process listens on stdio waiting for JSON-RPC 2.0 messages. Press Ctrl+C to exit.