선언적 스펙에서 Tableau 워크북을 작성하고, 설치된 Tableau Public 애플리케이션에서 열어 검증하며, Tableau 자체의 보이는 데스크톱 워크플로를 통해 게시하는 MCP 서버입니다.
이미 게시된 콘텐츠를 검사하는 기존 reader MCP (
tableau-public)의 대응물입니다. reader는 아무것도 만들거나 게시할 수 없습니다. 이 서버는 공개 프로필을 탐색할 수 없습니다. 둘 다 설치해 두세요.
아래의 모든 스크린샷은 이 서버가 JSON 스펙에서 생성한 워크북을 Tableau Public 2026.2.0에서 열어 촬영한 것입니다. 손으로 작성된 것은 없으며, 스크린샷을 찍기 전에 Tableau에서 건드린 것도 없습니다. 데이터는 tests/fixtures/data/에 있는 합성 12행 픽스처입니다.
대시보드 - 하나의 컨테이너에 타일로 배치된 두 개의 생성된 워크시트, 고정 1200×800 캔버스, 렌더링된 제목:
심볼 맵 - 열 이름에서 감지된 latitude/longitude가 Tableau의 [Geographical] 의미 역할로 태그되어, 마크 뒤에 실제 배경 지도를 배치합니다. 사이트당 하나의 마크이며, 차원으로 색상이 지정되고 측정값으로 크기가 지정됩니다:
막대 차트 - 차원별 색상, 그려진 마크 레이블, 적용된 캔버스 맞춤:
지도 뒤에 있는 스펙이 전체 입력입니다:
{
"name": "Site Map",
"template": "map",
"data_source": "sites",
"detail": ["Site Name"],
"color": "Status",
"size": { "field": "Annual Sessions", "aggregation": "Sum" },
"title": "Candidate sites"
}Related MCP server: tableau-audit-mcp
Reader MCP ( | 이 서버 ( | |
공개 프로필 검색 / 검사 | ✅ | ❌ |
| ✅ | 검사 전용 |
워크북 생성 | ❌ | ✅ |
Tableau Public에서 열기 | ❌ | ✅ |
계정에 게시 | ❌ | ✅ (보이는 UI) |
아래의 모든 내용은 XML을 생성하는 것에 그치지 않고, 워크북을 생성하여 macOS의 Tableau Public 2026.2.0에서 여는 것으로 확인되었습니다.
지원됨
CSV 데이터 소스, 자동으로 .hyper 추출로 구체화
필드 유형 추론: string, integer, real, boolean, date, datetime
워크시트 템플릿: bar, line, text_table, heatmap, scatter, circle, map (일곱 개 모두 Tableau Public 2026.2.0에서 스크린샷으로 검증되었으며, tests/live/test_render_templates.py가 모든 라이브 실행에서 다시 확인합니다)
지리적 역할: 이름으로 감지된 latitude/longitude 열. 이것이 map 템플릿 뒤에 실제 배경 지도를 배치합니다
대시보드: 제목, 고정 또는 자동 캔버스, 하나의 컨테이너에 타일로 배치된 워크시트
계산된 필드 (Tableau 수식 구문)
범주형 필터, 대화형 필터 카드로 렌더링
인코딩: color, size, label, tooltip 및 detail - detail은 세부 수준을 높이므로 산점도는 색상 값당 하나가 아니라 사이트당 하나의 마크를 그립니다
캔버스 맞춤: standard, fit_width, fit_height, entire_view
워크시트 제목 및 부제목
.twbx 패키징, 내부에 바이트 결정적인 .twb 포함
v0.1에서 지원되지 않음 - docs/architecture/CAPABILITY_BOUNDARY.md 참조
스토리, 매개변수, LOD 표현식, 조인/사용자 지정 SQL, 라이브 연결
집합, 그룹, 계층 구조, 테이블 계산, 참조선
채워진/코로플레스 맵, 사용자 지정 영역, 맵 레이어, 공간 파일
대시보드 필터 카드, 범례, 작업, 플로팅 영역, 기기 레이아웃
주의 깊게 읽어야 할 두 가지 주장
.twbx는 바이트 단위로 재현되지 않습니다. 내부의 .twb는 그렇습니다. 동일한 스펙이면 동일한 바이트입니다. 아카이브는 그렇지 않은데, 포함된 .hyper가 Tableau의 Hyper 엔진에 의해 작성되며 비결정적 내부 상태를 지니기 때문입니다. 패키지 다이제스트가 아니라 .twb를 diff하세요. docs/LIMITATIONS.md §1 참조.
독립형 .twb는 데이터 디렉터리와 함께 있을 때만 사용할 수 있습니다. output.package_twbx: false는 각 소스의 .hyper와 CSV를 담은 <name>.data/ 디렉터리 및 <name>.twb를 작성하며, .twb는 자신을 기준으로 데이터를 해석합니다. 따라서 둘을 함께 두거나 함께 이동하세요. 패키지 빌드는 아카이브 내부와 동일한 레이아웃을 Data/ 아래에 생성합니다. 경로는 선호가 아니라 필요에 따라 항상 상대적입니다. 절대 경로는 홈 디렉터리를 포함하게 되며, build_workbook은 기기 식별 데이터를 내보내는 것을 거부합니다 (docs/architecture/THREAT_MODEL.md, T6 참조).
Tableau Public에는 게시 API가 없습니다. REST API는 Server/Cloud만 다루므로 게시는 실제 UI를 통해 이루어집니다. Tableau는 이 명령을 Server > Tableau Public > Save to Tableau Public으로 문서화하지만, 이는 Desktop Professional 경로입니다. Public 에디션 (2026.2.0)에서 Server 메뉴에는 Run Optimizer...만 있으며 명령은 File 메뉴에 있습니다. 실제 Command+Shift+S 키 이벤트로 호출되며 File 메뉴가 대체 수단입니다 - docs/PUBLISHING_WORKFLOW.md 참조.
Tableau Public은 비추출 데이터 소스를 거부합니다 (Error Code: 3C242D89). 따라서 모든 CSV는 빌드 시점에 Hyper 추출로 변환됩니다.
uv tool install git+https://github.com/andyyaro/tableau-public-authoring-mcp
tableau-public-authoring doctor클론도, virtualenv도, 편집할 경로도 없습니다. doctor는 서버에 필요한 모든 것을 확인하고 정확히 무엇을 고쳐야 하는지 출력합니다. 등록 전에 실행하세요. 아래의 모든 전제 조건은 런타임에서 예외를 발생시키는 대신 조용히 실패하기 때문입니다:
[PASS] platform macOS
[PASS] python 3.13.14 at ~/.local/share/uv/tools/…/bin/python
[PASS] mcp sdk importable
[PASS] tableauhyperapi importable
[PASS] quartz (pyobjc) importable
[PASS] tableau public 2026.2.0 at /Applications/Tableau Public.app
[PASS] accessibility granted to this process
[PASS] screen recording capture succeeded누락 항목 | 실제로 보게 될 증상 |
Quartz | Tableau에 열린 창이 없는 것처럼 보임; 게시 시 "no document window matching …" 발생 |
Screen Recording | 검증 스크린샷이 오류 없이 빈 채로 반환됨 |
Accessibility | 키 입력과 클릭이 아무 데도 전달되지 않음 |
tableauhyperapi | 워크북을 전혀 빌드할 수 없음 |
macOS 권한은 실행 파일별로 부여되므로 doctor가 출력하는 인터프리터에 권한을 부여하세요. Tableau가 아니라, 다른 터미널을 등록하는 경우 그 터미널도 아닙니다. 자세한 내용은 docs/MACOS_PERMISSIONS.md에 있습니다.
요구 사항: Tableau Public이 설치된 macOS (2026.2.0, Apple silicon 기준으로 개발됨), Python ≥ 3.10, uv.
claude mcp add --transport stdio --scope user tableau-public-authoring \
-- tableau-public-authoring이것이 전체 명령입니다. uv tool install은 실행 파일을 안정적인 위치의 PATH에 두므로 대체할 절대 경로가 없고 업그레이드 후에도 유지됩니다. 등록은 다른 MCP 서버에 영향을 주지 않습니다. claude mcp list로 확인하세요. 도구가 나타나기 전에 Claude Code를 다시 시작하세요.
git clone https://github.com/andyyaro/tableau-public-authoring-mcp
cd tableau-public-authoring-mcp
uv venv && uv sync && uv pip install -e .
uv run tableau-public-authoring doctor해당 빌드를 인터프리터를 명시적으로 지정하여 등록하세요:
claude mcp add --transport stdio --scope user tableau-public-authoring \
-- /absolute/path/to/.venv/bin/python -m tableau_public_authoring.server등록된 서버에는 uvx --from …을 피하세요. 이는 종속성이 변경될 때마다 바뀌는 콘텐츠 해시 캐시 경로에서 실행되며, macOS 권한 부여가 해당 경로에 묶여 있기 때문에 다음 업그레이드에서 서버가 조용히 Accessibility와 Screen Recording 권한을 잃게 됩니다. uvx --from … tableau-public-authoring doctor 같은 일회성 사용에는 괜찮습니다.
uv tool upgrade tableau-public-authoring
tableau-public-authoring doctor{
"spec_version": "0.1",
"workbook": { "name": "EV Charging Readiness", "description": "Generated" },
"data_sources": [{ "id": "sites", "type": "csv", "path": "/abs/path/sites.csv" }],
"calculated_fields": [{
"name": "Readiness Band", "data_source": "sites", "datatype": "string",
"formula": "IF [Readiness Score] >= 70 THEN \"High\" ELSE \"Low\" END"
}],
"worksheets": [{
"name": "Readiness by Site", "template": "bar", "data_source": "sites",
"rows": ["Site Name"],
"columns": [{ "field": "Readiness Score", "aggregation": "Sum" }],
"color": "Readiness Band",
"filters": ["Status"],
"title": "EV Charging Readiness by Site"
}],
"output": { "directory": "/abs/path/output", "package_twbx": true }
}경로는 절대 경로 대신 단일 base_dir에 상대적일 수 있습니다. 상대 경로는 해당 디렉터리로 제한되지만 절대 경로는 그렇지 않습니다. docs/AUTHORING_SPEC.md 참조.
그런 다음: validate_workbook_spec (드라이 런) → build_workbook → validate_in_tableau_public → publish_to_tableau_public.
전체 스키마: schemas/workbook-spec-v0.1.json 및 docs/AUTHORING_SPEC.md.
이 코드베이스의 구조 대부분은 Tableau가 실제로 한 행동에 대한 대응입니다. docs/LIMITATIONS.md는 제약 사항을 나열하고, docs/history/CHANGE_HISTORY.md는 릴리스 기록을 보관하며, 각 수정이 대응한 실패와 무엇이 수정되었는지 입증했는지를 기록합니다. docs/fixtures/는 컴파일러가 리버스 엔지니어링한 실제 게시 워크북의 포렌식 분석을 담고 있습니다.
publish_to_tableau_public은 파괴적(destructive)으로 표시되어 있으며 confirm_publish: true와 profile (사용자의 Tableau Public 프로필 이름)을 모두 요구합니다. overwrite는 기본값이 false입니다. profile이 필요한 이유는 그것 없이는 서버가 해당 이름의 워크북이 이미 게시되어 있는지 확인할 수 없고, Tableau Public은 같은 이름의 워크북을 버전 기록 없이 되돌릴 수 없게 교체하기 때문입니다.
이 도구는 보이는 명령을 구동하며 자격 증명을 읽거나, 입력하거나, 저장하지 않습니다. 이미 로그인된 데스크톱 세션을 사용합니다. Tableau가 로그인을 요구하면 도구는 중단되고 수동으로 로그인하라고 안내합니다. 게시는 되돌릴 수 없으며 전 세계에 공개됩니다.
dry_run: true를 사용하면 먼저 정확히 어떤 일이 일어날지 확인할 수 있습니다.
uv run pytest # unit + integration (no Tableau needed)
uv run pytest -m live # requires Tableau Public installed
uv run ruff check . && uv run ruff format --check .live 및 publish 테스트는 일반 실행에서 제외되며 CI에서 절대 실행되어서는 안 됩니다.
어디에도 자격 증명이 저장되지 않습니다. XML은 ElementTree를 통해 생성되며 (절대 문자열 연결이 아님), 아카이브는 ZIP-slip으로 보호되고, 경로는 트래버설 검사를 거치며, 생성된 워크북은 패키징 전에 기기 식별 데이터가 있는지 스캔됩니다. docs/SECURITY.md 및 docs/architecture/THREAT_MODEL.md 참조.
claude mcp remove --scope user tableau-public-authoring이렇게 해도 다른 모든 MCP 서버는 영향을 받지 않습니다.
claude mcp remove tableau-public-authoring -s user
claude mcp list # your other servers should still be listed
rm -rf <this repo>/output # generated workbooks are inert local files이미 게시된 항목은 브라우저에서 사용자의 Tableau Public 프로필에서 직접 삭제해야 합니다. 이 서버는 설계상 삭제 기능이 없습니다. 게시는 서버 측에서 되돌릴 수 없기 때문에 confirm_publish를 요구하고 overwrite를 전달하지 않는 한 이름 충돌을 거부합니다.
MIT - LICENSE 참조.
PRIMARY TOOL. Compile a specification into a .twb and packaged .twbx with Hyper extracts (required by Tableau Public). Writes files to the spec's output.directory. The .twb is byte-deterministic for an identical spec; the .twbx digest is not, because the embedded Hyper extract carries non-deterministic state.
Inputs: spec (required), overwrite.
Report what this server can and cannot author, the detected Tableau Public installation, and the macOS permission state. Read-only.
Inputs: no named parameters.
Report Tableau Public installation, version, running state, open windows and Accessibility permission. Read-only.
Inputs: no named parameters.
Safely inspect a local .twbx archive's contents. Read-only.
Inputs: path (required).
List supported worksheet templates and their required shelves. Read-only.
Inputs: no named parameters.
Open a generated workbook in Tableau Public and wait for its window. Returns the load error verbatim if Tableau rejects the file.
Inputs: path (required), timeout_s.
DESTRUCTIVE / PUBLIC. Publish an open workbook to the user's Tableau Public account through the visible Server > Tableau Public > Save to Tableau Public workflow. Publication is irreversible and world-visible. Requires confirm_publish=true. Never reads credentials; pauses for manual sign-in if required.
Inputs: profile (required), public_name (required), confirm_publish (required), workbook_window (required), +5 more.
Layer 3+4 validation: open the workbook in Tableau Public, detect error dialogs, and capture a screenshot proving rendered content.
Inputs: path (required), settle_s, screenshot_dir.
Validate an authoring specification without writing any files (dry run). Returns actionable errors. Read-only.
Inputs: spec (required).
Layer 5 validation: load a public Tableau URL and confirm it responds. Read-only.
Inputs: url (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Scored across 10 tools
Each tool has a clearly distinct purpose: capabilities, templates, validation, building, inspection, app status, opening, in-app validation, publishing, and verification. No two tools overlap in function, and descriptions clearly differentiate them.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_authoring_capabilities, build_workbook, publish_to_tableau_public). No mixing of conventions, and verbs clearly indicate the action.
Ten tools is well-scoped for the domain of authoring and publishing Tableau Public workbooks. Each tool serves a necessary step in the workflow, from capability reporting to verification.
The tool set covers the full authoring and publishing lifecycle: capabilities, templates, dry-run validation, building, local inspection, app status, opening, in-app validation, publishing, and web verification. No obvious gaps for the stated purpose.
Generate Tableau .twb/.twbx workbooks: 47 tools for charts, dashboards, rules, CSV pipelines.
Build, run and publish Workbench flows, tasks, shims and knowledge bases.
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
Excel analytics: inspect, query (JSON rows), charts, and JSON-to-xlsx workbook writing.
