Tableau MCP Server

A Model Context Protocol (MCP) server for Tableau Cloud and Tableau Server operations.

Project Status

Current Phase: Phase 6 Complete ✅ - Ready for Cloud Run Deployment

Completed Phases

• ✅ Phase 1: Project Setup

• ✅ Phase 2: Tableau API Client (13 methods)

• ✅ Phase 3: MCP Server Core (SSE transport, authentication)

• ✅ Phase 4: Core MCP Tools (6 tools)

• ✅ Phase 5: Advanced MCP Tools (3 tools)

• ✅ Phase 6: Cloud Run Deployment Infrastructure ✨ NEW!

Phase 6 Deliverables

• ✅ Optimized multi-stage Dockerfile

• ✅ Staging and production Cloud Run configurations

• ✅ Automated deployment scripts (deploy-staging.sh, deploy-production.sh)

• ✅ Secrets management automation (create-secrets.sh)

• ✅ Comprehensive deployment documentation (2,000+ lines)

• ✅ Automated testing script (smoke-test.sh)

• ✅ Monitoring and logging guides

Next Steps

1. Deploy to staging: Run ./deploy-staging.sh (requires Google Cloud project)

2. Test deployment: Run ./smoke-test.sh staging

3. Phase 7: Create Cursor MCP configuration file

4. Phase 8: Comprehensive testing and documentation

See PHASE_6_LOG.md for detailed Phase 6 implementation notes.
See PASS_OFF.md for complete project roadmap.

Project Structure

Development Scripts

Quick Start - Cloud Run Deployment (Phase 6)

Prerequisites

• Google Cloud Project with billing enabled

• gcloud CLI installed and authenticated

• Docker installed locally

• Tableau Personal Access Token

Deploy to Staging

1. Create secrets:

2. Deploy service:

3. Test deployment:

Deploy to Production (When Ready)

Comprehensive Guides

• Deployment: See DEPLOYMENT_GUIDE.md

• Secrets: See SECRETS_SETUP.md

• Testing: See TEST_DEPLOYMENT.md

• Monitoring: See MONITORING_GUIDE.md

• Phase 6 Log: See PHASE_6_LOG.md

Environment Configuration

Copy env.example to .env and configure:

Dependencies

Core Dependencies

• @modelcontextprotocol/sdk (^1.0.4) - MCP Server SDK

• express (^4.21.2) - HTTP server for SSE transport

• axios (^1.7.9) - HTTP client for Tableau REST API

• zod (^3.24.1) - Schema validation

• dotenv (^16.4.7) - Environment variable management

Development Dependencies

• typescript (^5.7.2) - TypeScript compiler

• tsx (^4.19.2) - TypeScript execution and hot reload

• @types/node & @types/express - Type definitions

Phase 1 Implementation Log

See PHASE_1_LOG.md for detailed implementation steps.

Next Implementation Phase

See PASS_OFF.md for Phase 2-8 implementation details.

License: MIT
Author: Agile Market Intelligence