Skip to main content

MCP server for Glassbox — mechanistic interpretability + EU AI Act Annex IV compliance tools for Claude and any MCP-compatible client

Project description

glassbox-mcp

MCP server for Glassbox — mechanistic interpretability + EU AI Act Annex IV compliance tools, exposed via the Model Context Protocol.

Connect Claude (or any MCP-compatible client) to Glassbox with a single pip install. No cloning, no manual server setup.

Install

pip install glassbox-mcp

Connect to Claude Desktop

Add to ~/.claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "glassbox": {
      "command": "glassbox-mcp"
    }
  }
}

Restart Claude Desktop. The Glassbox tools appear immediately.

Tools

Tool What it does
glassbox_circuit_discovery Attribution patching — find which attention heads causally drive a prediction
glassbox_faithfulness_metrics Compute sufficiency, comprehensiveness, F1, and EU AI Act explainability grade (A–D)
glassbox_compliance_report Generate a full EU AI Act Annex IV evidence package (all 9 sections)
glassbox_attention_patterns Get attention weight heatmap for any layer/head
glassbox_logit_lens Layer-by-layer residual stream projection — see how predictions build up

Supported Models

  • gpt2, gpt2-medium, gpt2-large
  • EleutherAI/pythia-70m, pythia-160m, pythia-410m

Example usage in Claude

Once connected, ask Claude things like:

"Use Glassbox to analyse which attention heads drive GPT-2's prediction for 'The Eiffel Tower is in' → ' Paris'"

"Generate an EU AI Act Annex IV compliance report for GPT-2 with provider name Acme Corp"

"Show me the logit lens for GPT-2 on this sentence"

Requirements

  • Python ≥ 3.10
  • ~3 GB disk (PyTorch + TransformerLens model weights download on first use)

Version

4.2.4 — tracks glassbox-mech-interp v4.2.4

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glassbox_mcp-4.2.4.tar.gz (11.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

glassbox_mcp-4.2.4-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

Details for the file glassbox_mcp-4.2.4.tar.gz.

File metadata

  • Download URL: glassbox_mcp-4.2.4.tar.gz
  • Upload date:
  • Size: 11.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for glassbox_mcp-4.2.4.tar.gz
Algorithm Hash digest
SHA256 6f653e51527ade7865ad39086af39d8956ca20ec762c62762d4241076dde7b49
MD5 4d122af4521c8386f7ac932d3ba09fe1
BLAKE2b-256 b202e85fa806e441a000f854e1246b585414e74e3a8f3f5a524502d538c57e2b

See more details on using hashes here.

File details

Details for the file glassbox_mcp-4.2.4-py3-none-any.whl.

File metadata

  • Download URL: glassbox_mcp-4.2.4-py3-none-any.whl
  • Upload date:
  • Size: 11.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for glassbox_mcp-4.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e85b76befbdd21ba0fbbf2115b03d5e6c3fe7c8df31c8d56149f8280a7d0f3d5
MD5 d97da473297eca1ded824b5dedd158a2
BLAKE2b-256 31b03aea9ed673835c128b561af2347322cae939a4fc01e24cf84c19452ec875

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page