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

tableau-mcp-project/
├── src/
│   ├── server.ts              # Main MCP server (Phase 3)
│   ├── tableau-client.ts      # Tableau API client (Phase 2)
│   ├── tools/                 # MCP tool implementations (Phase 4-5)
│   │   ├── list-workbooks.ts
│   │   ├── list-views.ts
│   │   ├── query-view.ts
│   │   ├── refresh-extract.ts
│   │   ├── search-content.ts
│   │   └── get-metadata.ts
│   └── types.ts               # TypeScript type definitions
├── package.json
├── tsconfig.json
├── Dockerfile                 # Cloud Run deployment (Phase 6)
└── env.example               # Environment variable template

Development Scripts

# Install dependencies
npm install

# Run in development mode with hot reload
npm run dev

# Build for production
npm run build

# Run production build
npm start

# Clean build artifacts
npm run clean

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:

chmod +x create-secrets.sh
./create-secrets.sh staging

2. Deploy service:

chmod +x deploy-staging.sh
./deploy-staging.sh

3. Test deployment:

chmod +x smoke-test.sh
./smoke-test.sh staging

Deploy to Production (When Ready)

# Create production secrets
./create-secrets.sh production

# Deploy to production
chmod +x deploy-production.sh
./deploy-production.sh

# Test production deployment
./smoke-test.sh production

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:

TABLEAU_SERVER_URL=https://your-server.tableau.com
TABLEAU_SITE_ID=your-site
TABLEAU_TOKEN_NAME=your-token-name
TABLEAU_TOKEN_VALUE=your-token-value
MCP_API_KEY=secure-random-key-here
PORT=8080
TABLEAU_API_VERSION=3.21

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