theo-van-gogh-mcp

MCP server that exposes the theo-van-gogh art management system to Claude (or any MCP-compatible AI).

What it does

Lets an AI assistant manage your art catalogue — find paintings, post to social media, upload to gallery sites, schedule posts, and update metadata — by calling tools over the Model Context Protocol.

Related MCP server: social0-mcp

Setup

1. Install mcp into the main project's virtualenv

The MCP server runs inside theo-van-gogh's existing virtualenv so it has access to all dependencies.

cd ~/programming/theo-van-gogh
source venv/bin/activate
pip install "mcp[cli]"

2. Configure Claude Desktop

Merge the following into ~/.config/claude/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "theo-van-gogh": {
      "command": "/home/christopher/programming/theo-van-gogh/venv/bin/python",
      "args": ["/home/christopher/programming/theo-van-gogh-mcp/server.py"],
      "env": {
        "THEO_VAN_GOGH_PATH": "/home/christopher/programming/theo-van-gogh"
      }
    }
  }
}

See claude_desktop_config.example.json for a copy-pasteable example.

3. Restart Claude Desktop

The server starts automatically when Claude Desktop launches.

Available tools

Available resources

What stays manual

• First browser login for FASO and Cara — use admin option 17 in the main CLI

• Processing new paintings (AI title generation, entering dimensions) — use python main.py process

Support

If you find this useful, a small donation helps keep projects like this going: Donate via PayPal