textual-docs-mcp

An MCP server for Textual TUI framework documentation, code examples, widget references, and best practices.

What You Get

This MCP server has:

• Full-text BM25 search across all Textual documentation, guides, and examples
• Widget documentation — complete reference for every built-in widget
• Guide retrieval — layout, events, reactivity, CSS, workers, screens, and more
• Code examples — real, runnable Python examples covering common Textual patterns
• Topic catalogues — browse all available guides and widgets

All documentation is bundled inside the package — no external API calls, no network requests, no rate limits.

Installation

pip (recommended)

pip install textual-docs-mcp

From Source

git clone https://github.com/diaz3618/textual-docs-mcp.git
cd textual-docs-mcp
pip install -e ".[dev]"

Docker

docker pull ghcr.io/diaz3618/textual-docs-mcp:latest

Or build locally:

docker build -t textual-docs-mcp .

Usage

Stdio Transport (MCP Clients)

textual-docs-mcp
# or
python -m textual_docs_mcp

Docker

docker run -i textual-docs-mcp

MCP Client Configuration

{
  "mcpServers": {
    "textual-docs": {
      "command": "uvx",
      "args": ["textual-docs-mcp"]
    }
  }
}

claude mcp add --scope user textual-docs -- uvx textual-docs-mcp

{
  "servers": {
    "textual-docs": {
      "type": "stdio",
      "command": "uvx",
      "args": ["textual-docs-mcp"]
    }
  }
}

{
  "mcpServers": {
    "textual-docs": {
      "command": "uvx",
      "args": ["textual-docs-mcp"]
    }
  }
}

{
  "mcpServers": {
    "textual-docs": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/diaz3618/textual-docs-mcp:latest"]
    }
  }
}

More client configurations →

Available Tools

Development

# Install with dev dependencies
make dev

# Run tests
make test

# Run all checks (lint, typecheck, deadcode)
make check

# Build Docker image
make docker-build

# Rebuild documentation bundle (requires Textual source)
TEXTUAL_REPO_PATH=/path/to/textual make bundle

See make help for all available targets.

More Documentation

• Installation & Clients — Setup for multiple MCP clients
• Available Tools — Detailed tool reference
• Skills & Agents — Enhance your AI assistant
• Architecture — Module design, data flow, bundle format

Plugins

Pre-configured plugins for popular AI coding assistants:

• Claude Code — MCP config, skills, agents
• Cursor — MCP config, rules, skills

License

MIT