Backbone MCP Server

An MCP (Model Context Protocol) server that gives AI coding assistants direct access to the Backbone AI platform — manage schemas, run extractions, convert documents, and more from your IDE.

Installation

npm install -g @manfred-kunze-dev/backbone-mcp-server

Or run directly with npx (no install needed):

npx @manfred-kunze-dev/backbone-mcp-server

Quick Start

1. Create an API key in the Backbone dashboard under API Keys
2. Add the server to your IDE's MCP configuration (see below)
3. Start asking your AI assistant to manage your Backbone resources

IDE Configuration

Claude Code

Add to .claude/settings.local.json in your project root:

{
  "mcpServers": {
    "backbone": {
      "command": "npx",
      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
      "env": {
        "BACKBONE_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "backbone": {
      "command": "npx",
      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
      "env": {
        "BACKBONE_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Windsurf

Add to .windsurf/mcp.json in your project root:

{
  "mcpServers": {
    "backbone": {
      "command": "npx",
      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
      "env": {
        "BACKBONE_API_KEY": "sk_your_api_key"
      }
    }
  }
}

OpenAI Codex CLI

Add to ~/.codex/config.json:

{
  "mcpServers": {
    "backbone": {
      "command": "npx",
      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
      "env": {
        "BACKBONE_API_KEY": "sk_your_api_key"
      }
    }
  }
}

Works with any MCP-compatible client using the same configuration pattern.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | BACKBONE_API_KEY | Yes | — | API key for authenticating with the Backbone backend | | BACKBONE_BASE_URL | No | https://backbone.manfred-kunze.dev/api | Base URL of your Backbone instance | | MCP_TRANSPORT | No | stdio | Transport mode: stdio or http | | MCP_HTTP_PORT | No | 3100 | Port for HTTP transport |

Available Tools

| Category | Tools | |----------|-------| | Schemas | CRUD operations, version management, validation, testing | | Extractions | Create extractions (sync/async), estimate tokens, re-run | | Document Conversion | Convert PDFs, DOCX, images to Markdown/text/HTML/JSON | | Transcription | Transcribe audio files (flac, mp3, mp4, ogg, wav, webm) | | AI Gateway | Chat completions, list available models | | API Docs | Browse API documentation by section |

For full tool documentation, see the Backbone docs.

License

Proprietary — see LICENSE for details.