tavant-docs-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 crow2678
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/brand.js

@@ -0,0 +1,21 @@
+const path = require("path");
+
+const BRAND = {
+  colors: {
+    orange: "F36E26",
+    black: "000000",
+    white: "FFFFFF",
+    darkBg: "1A1A1A",
+    lightGray: "F5F5F5",
+    mediumGray: "666666",
+    darkGray: "333333",
+  },
+  font: "Aptos",
+  company: "Tavant",
+  footer: "Tavant & Customer Confidential",
+  logo: {
+    path: path.join(__dirname, "assets", "tavant-logo.png"),
+  },
+};
+
+module.exports = BRAND;

package/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = require("zod");
+const fs = require("fs");
+const path = require("path");
+const BRAND = require("./brand");
+
+// ─── Template modules ──────────────────────────────────────────────────
+const pptx = require("./templates/pptx/register");
+const contract = require("./templates/contract/register");
+const sow = require("./templates/sow/register");
+const nda = require("./templates/nda/register");
+const cr = require("./templates/cr/register");
+const msa = require("./templates/msa/register");
+
+// ─── Knowledge base ────────────────────────────────────────────────────
+const KNOWLEDGE_DIR = path.join(__dirname, "knowledge");
+
+function loadKnowledge() {
+  const files = fs.readdirSync(KNOWLEDGE_DIR).filter(f => f.endsWith(".md"));
+  const knowledge = {};
+  for (const file of files) {
+    const name = file.replace(".md", "");
+    knowledge[name] = fs.readFileSync(path.join(KNOWLEDGE_DIR, file), "utf-8");
+  }
+  return knowledge;
+}
+
+// ─── MCP Server ────────────────────────────────────────────────────────
+const server = new McpServer({
+  name: "tavant-docs",
+  version: "1.0.0",
+});
+
+// Global tool: brand guidelines
+server.tool(
+  "get_brand_guidelines",
+  "Get Tavant brand guidelines (colors, fonts, layout rules) and list all available document types",
+  {},
+  async () => ({
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        brand: "Tavant",
+        primary_color: `#${BRAND.colors.orange} (Orange)`,
+        backgrounds: { dark: `#${BRAND.colors.darkBg}`, white: `#${BRAND.colors.white}` },
+        font: BRAND.font,
+        footer: BRAND.footer,
+        document_types: {
+          pptx: "PowerPoint presentations — use pptx_* tools",
+          contract: "Contract agreements (Word .docx) — use contract_* tools",
+          sow: "Statements of Work (Word .docx) — use sow_* tools",
+          nda: "Mutual Non-Disclosure Agreements (Word .docx) — use nda_* tools",
+          cr: "Change Requests (Word .docx) — use cr_* tools",
+          msa: "Master Services Agreement / Professional Services Agreement (Word .docx) — use msa_* tools",
+        },
+        guidelines: [
+          "Every document uses Tavant branding: orange #F36E26, Aptos font",
+          "Presentations: start with title_cover, end with thank_you",
+          "Contracts: include at minimum parties, scope_of_work, commercial_terms, signatures",
+          "SOWs: include at minimum cover_page, overview, scope, deliverables, pricing, signatures",
+        ],
+      }, null, 2),
+    }],
+  })
+);
+
+// Knowledge resource: Tavant company context
+server.resource(
+  "tavant-company-knowledge",
+  "knowledge://tavant-company",
+  "Tavant company knowledge base — services, practices, capabilities, case studies, technology stack. Use this to get context when creating presentations, contracts, or SOWs about Tavant.",
+  async (uri) => {
+    const knowledge = loadKnowledge();
+    const allContent = Object.values(knowledge).join("\n\n---\n\n");
+    return {
+      contents: [{
+        uri: uri.href,
+        mimeType: "text/markdown",
+        text: allContent,
+      }],
+    };
+  }
+);
+
+// Tool: get Tavant company context
+server.tool(
+  "get_tavant_context",
+  "Get Tavant company knowledge — services, AI practice, data practice, AIOps, automation capabilities, analytics framework, technology stack, and client case studies. ALWAYS call this before creating presentations about Tavant to get accurate content.",
+  {
+    topic: z.string().optional().describe(
+      "Optional: filter by topic — 'services', 'ai_practice', 'automation', 'data', 'aiops', 'analytics', 'technology', or leave empty for all"
+    ),
+  },
+  async ({ topic }) => {
+    const knowledge = loadKnowledge();
+    const fullText = knowledge["tavant-company"] || "";
+
+    if (!topic) {
+      return { content: [{ type: "text", text: fullText }] };
+    }
+
+    // Topic-based filtering by section headers
+    const topicMap = {
+      services: "Service Portfolio",
+      ai_practice: "AI & Agentic AI Practice",
+      automation: "AI & Automation",
+      data: "Data Transformation Practice",
+      aiops: "AIOps for Data Platforms",
+      analytics: "Analytics Framework",
+      technology: "Technology Stack",
+    };
+
+    const sectionHeader = topicMap[topic.toLowerCase()];
+    if (!sectionHeader) {
+      return { content: [{ type: "text", text: fullText }] };
+    }
+
+    // Extract the relevant section
+    const lines = fullText.split("\n");
+    let capturing = false;
+    let result = [];
+    let headerLevel = 0;
+
+    for (const line of lines) {
+      if (line.startsWith("## ") && line.includes(sectionHeader)) {
+        capturing = true;
+        headerLevel = 2;
+        result.push(line);
+        continue;
+      }
+      if (capturing) {
+        if (line.startsWith("## ") && !line.includes(sectionHeader) && line !== "---") {
+          break; // Next top-level section
+        }
+        if (line === "---") {
+          break;
+        }
+        result.push(line);
+      }
+    }
+
+    return {
+      content: [{
+        type: "text",
+        text: result.length > 0 ? result.join("\n") : fullText,
+      }],
+    };
+  }
+);
+
+// Register all template tools
+pptx.register(server);
+contract.register(server);
+sow.register(server);
+nda.register(server);
+cr.register(server);
+msa.register(server);
+
+// ─── Start ─────────────────────────────────────────────────────────────
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Tavant Docs MCP server running (pptx + contract + sow + nda + cr + msa)");
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/knowledge/tavant-company.md

@@ -0,0 +1,181 @@
+# Tavant — Company Knowledge Base
+
+## Company Overview
+Tavant is a technology company delivering end-to-end Digital, AI, Data & Platform capabilities across industries. Domain focus areas: **Financial Services, Media & Digital Consumer, Manufacturing & Agriculture**.
+
+## Service Portfolio
+
+### 1. DIGITAL — GenAI-Accelerated SW Development & Digital Engineering
+Step-function improvement in efficiency and speed in SW development, maintenance and app modernization.
+- Custom Application Development
+- Legacy App Modernization
+- Strategic IT Outsourcing
+- Enterprise Platforms (Salesforce, ServiceNow)
+
+### 2. AI — Enterprise Transformation through Agentic AI
+Next-gen enterprise efficiency and platform transformation powered by orchestrated Agents.
+- AI Agents: Customer Service, Personal Advisors, Assistants, Enterprise Agents
+- Agentic AI Architecture & Platforms
+
+### 3. DATA SCIENCE — Data Science-powered Revenue & Productivity Growth
+AI-powered custom solutions for business top-line growth, efficiency and productivity.
+- AI/ML Models, Search & Intelligent Apps
+- Customer NBO, Cognitive Solutions, Predictive Decisions
+- Global Data Science Factory
+- AI/ML Ops
+
+### 4. DATA — Data & Cloud Modernization & Compliance
+Data platform modernization and operations for rapid, reliable access to trusted data.
+- Data Architecture & Cloud (Azure, AWS, Databricks, Snowflake)
+- Data Quality, Privacy, Governance & Compliance
+- Data Ops
+
+### 5. AI PLATFORM — Industry-Specific AI Transformation Platforms
+Accelerators for rapid AI transformation of high-ROI business problems.
+- TOUCHLESS: AI Transformation Platform for Lending
+- AI Platform for Service Lifecycle Management & Aftermarket
+- Tavant AIgnite™: AI Accelerator & Enterprise AI Transformation Platform
+
+---
+
+## AI & Agentic AI Practice
+
+**75+ data scientists** with depth in critical technology areas, cross-industry & domain-specific use cases.
+
+### AI/ML Services
+- AI/ML Model Development
+- Cognitive Solutions (NLP, Image, Vision)
+- Customer Analytics
+- AI/ML Ops
+
+### Agent Services
+- Enterprise Agents (Search, Finance, HR, ...)
+- Workflow / Orchestration Agents
+- Customer Service Agents
+- Field Service Support Agents
+
+### AIgnite™ AI Platform
+**AIgnite™ AI — Search:**
+- Pre-built GenAI agents for rapid conversational deployments
+- Multi-LLM & advanced retrieval ensuring accurate responses
+- Enterprise-grade security, governance & compliance
+- Dynamic orchestration supporting complex workflows
+
+**AIgnite™ AI — Models:**
+- Structured methodology accelerating AI development
+- Built-in governance ensuring compliance & quality
+- Pre-built accelerators for faster time-to-market
+
+### Technology Partners & Frameworks
+TensorFlow, Python, Azure AI Studio, Microsoft Copilot Studio, Amazon SageMaker, Agentforce, Amazon Bedrock, Vertex AI, AutoGen, CrewAI, LangGraph, LangChain, Atomic Agents
+
+---
+
+## AI & Automation — Agentic AI in Action
+
+Deployment of AI Agents across verticals — proven delivery of agentic solutions at enterprise scale.
+
+### Customer Service Agents
+- Player & game provider CS automation for leading global gaming company
+- Customer servicing agent for a leading US mortgage company
+- Finance mailbox processing automation for major US farming cooperative
+
+### Supply Chain Agents
+- Workforce orchestration & yield forecasting for world's largest palm oil producer
+- Invoice processing automation for major US farming cooperative
+- After-market service agents for global agriculture equipment manufacturer
+
+### Productivity Assistants
+- Ad sales assistant with end-to-end campaign optimization for leading media conglomerate
+- Loan Officer assistant for a major US mortgage company
+- Field Service assistant for issue triaging at global heavy equipment manufacturer
+
+### Enterprise Function Agents
+- Technical issue classification agent for a global digital travel player
+- Financial agent for reconciliation & auditing at leading digital gaming company
+- Accrual agent for purchase orders; Workday agent for performance calibration
+
+### IT Automation Agents
+- OpsPilot agent for L1/L2 ticket resolution
+- Data pipeline automation through agents for a global Big Tech player
+- Infrastructure ticket processing automation for leading US sports media company
+
+### Highlight
+End-to-end agentic orchestration for Mortgage origination. Enterprise agentic platform for global gaming platform.
+
+---
+
+## Data Transformation Practice
+
+**400+ Associates, 100+ Certifications, 30+ Major implementations** (Lakes, Warehouses, Mesh, Fabric).
+
+Industries: Mortgage, Fintech, Media, Travel, Manufacturing, Retail.
+Technologies: Spark, Databricks, Snowflake, Salesforce, AWS, Azure, GCP.
+
+### Services
+- **Data Transformation & Analytics:** Scalable ETL/ELT pipelines, data enrichment, interactive dashboards
+- **Data Ops / Data Reliability:** Real-time observability, automated retry/rollback/self-healing, compute & storage optimization
+- **Cloud Transformation:** Re-platform legacy to Snowflake, Databricks, Azure Synapse; hybrid architectures
+- **Data Compliance & Governance:** Data Governance, Quality, Meta Data Management, Privacy & Regulatory Compliance, MDM, Audit Readiness
+
+### AIgnite™ Datascape
+- AI-generated Data Pipelines: Converts requirements into full systems (not just code snippets). Effective in migrations
+- Multi-cloud & Multi-tech: Supports AWS, Azure, GCP, Databricks, Snowflake, dbt
+- Integrated DataOps, FinOps & Governance: Automated monitoring, incident resolution, cost optimization
+
+---
+
+## AIOps for Data Platforms
+
+**Cut MTTR 50–70% and raise SLA adherence to 90–95% in ≤90 days.**
+
+### Business Outcomes
+- MTTR ↓ 50–70% (auto-triage + safe actions)
+- SLA adherence ↑ to 90–95% (predictive breach alerts)
+- Data quality incidents ↓ 40–60% (proactive drift checks)
+- Engineer productivity ↑ 25–35% (fewer escalations)
+
+### Optimization Areas
+- **Observability:** Logs, metrics, traces (CloudWatch / Datadog / OTel), lineage & ownership map
+- **Pipelines & Runtimes:** Airflow, Argo, Databricks, Spark, dbt, Snowflake, BigQuery, Redshift, Kafka, Kubernetes
+- **Data Quality:** Volume/schema/cardinality drift, partition/file health, PII policy checks
+- **Performance/Cost:** Skew, spill, cache churn, small files, slots/credits/DBUs
+
+### 90-Day Playbook
+- **0–14 Days (Assess & Quick Wins):** Alert dedupe, baseline DQ, guarded restart. MTTR ↓ 5–10%
+- **15–45 Days (Optimize):** Predictive SLA alerts, KG-aware routing, RCA auto-drafts. MTTR ↓ 10–25%, SLA ↑ 88–92%
+- **46–90 Days (Industrialize):** Guardrails-as-code, canary gates, RL safe actions. MTTR ↓ 25–60%, SLA ↑ 90–98%
+
+---
+
+## Analytics Framework
+
+Combination of Statistical Models → ML Models → Agentic AI for insights & recommendations.
+
+### Statistical Layer
+- **Deviation Detector:** Real-time anomaly detection across metrics (z-scores, seasonal adjustment)
+- **Benchmark Analyzer:** Peer cohort ranking, percentile distributions (P25–P90)
+
+### Classical ML Layer
+- **Trend Classification Engine:** 30–90 day revenue forecasting, momentum patterns
+- **Priority & Action Classifier:** Opportunity/risk scoring, optimal intervention types
+
+### Agentic AI Layer
+- **Insight Synthesizer:** Natural language strategic takeaways, 80% reduction in executive time-to-insight
+- **Action Recommender:** Personalized actions with ROI estimates and implementation roadmaps
+
+---
+
+## Technology Stack (Reference Architecture — AWS-Native)
+
+| # | Layer | Technology | Purpose |
+|---|-------|-----------|---------|
+| 01 | Data Management | AWS S3 + Redshift | Cleansed source data for analytics |
+| 02 | Data Processing | AWS Glue + Redshift | Aggregations, statistical analysis |
+| 03 | Machine Learning | AWS SageMaker | Model development, training, management |
+| 04 | AI Agents | AWS Bedrock + Agents | Agent orchestration, guardrails |
+| 05 | API | Lambda + API Gateway | Secure data delivery |
+| 06 | UI Hosting | AWS Amplify | React-based dashboards |
+| 07 | Governance | CloudWatch, Secrets Manager, KMS | Logging, secrets, key management |
+
+Stack philosophy: Fully AWS-native, managed services, designed for rapid MVP with path to production-grade.

package/knowledge/tavant-template.md

@@ -0,0 +1,61 @@
+# Tavant Corporate Template 2025 — Reference
+
+## Slide Size
+13.33" x 7.50" (Widescreen 16:9)
+
+## Brand Elements
+- **Primary Color:** Orange #F36E26 (accents, headers, highlights)
+- **Secondary Orange:** #F77A33 (subtitles)
+- **Accent Orange:** #FF8909 (bullet points, content text on dark)
+- **Dark Background:** #222222 (dark content slides)
+- **Grey Background:** #77787B (chart slides)
+- **Black Background:** #000000 (case studies, quotes, timeline)
+- **Orange Background:** #F26F26 (horizontal timeline)
+- **Font:** Aptos throughout
+- **Footer:** "Tavant & Customer Confidential" on every slide
+- **Footer bar:** Black bar with orange triangle accent at bottom
+
+## 23 Available Layouts
+
+### Opening & Closing
+1. **title_cover** — Dark tech imagery, large title (3 lines max), subtitle, date, orange Tavant logo
+2. **thank_you** — Dark abstract imagery, "THANK YOU", office locations, contact info
+
+### Section Dividers
+3. **breaker_ai** — AI brain imagery background, bold orange title, key points
+4. **breaker_cloud** — Cloud/abstract imagery, bold orange title
+5. **breaker_abstract** — Abstract lines imagery, bold orange title
+6. **agenda** — Dark data-waves background, numbered orange items (up to 6)
+
+### Content Slides (White Background)
+7. **content** — Title + content area (bullets or text)
+8. **title_subtitle_content** — Title + orange subtitle + content area (most versatile)
+9. **title_subtitle** — Title + subtitle only (for section intros)
+10. **two_column** — Title + subtitle + two equal content columns
+11. **title_only** — Title only, open space below
+12. **blank** — Empty with footer only
+
+### Content Slides (Dark Background)
+13. **content_dark** — Dark grey, title + content (orange text)
+14. **title_only_dark** — Dark grey, title only
+
+### Visual/Image Layouts
+15. **multi_case_study** — Black bg, 4 white card columns (for case studies)
+16. **image_content_a** — White, content left + image right
+17. **image_content_b** — Black, image left + 2 topic boxes right + body below
+18. **image_grid** — Image top, 2x3 text grid below
+19. **three_column_images** — Black, 3 image slots + 3 numbered topic blocks
+20. **multi_quote** — Black, 3 rows with logo left + quote right
+
+### Data & Timeline
+21. **chart** — Grey bg, content left + chart right + takeaway box
+22. **timeline_vertical** — Black, 3 KPI blocks + year highlight (for metrics over time)
+23. **timeline_horizontal** — Orange bg, 8 milestone points (for roadmaps)
+
+## Common Positioning Reference
+- **Title:** x=0.36, y=0.37, w=12.62, h=0.39, 24pt bold Aptos
+- **Subtitle:** x=0.36, y=0.78, w=12.62, h=0.41, 18pt #F77A33
+- **Content area:** x=0.35, y=1.38, w=12.63, h=5.30, 18pt
+- **Footer bar:** y=6.83, full width
+- **Confidential text:** x=10.15, y=7.15, 10.7pt
+- **Logo position:** x=12.63, y=7.02 (small orange logo on footer)

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "tavant-docs-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for creating Tavant corporate documents — presentations, contracts, and SOWs",
+  "main": "index.js",
+  "bin": {
+    "tavant-docs-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "test": "node test-e2e.js"
+  },
+  "keywords": [
+    "mcp",
+    "pptx",
+    "docx",
+    "contract",
+    "sow",
+    "tavant"
+  ],
+  "author": "Tavant",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "docx": "^9.6.1",
+    "jszip": "^3.10.1",
+    "pptxgenjs": "^4.0.1",
+    "uuid": "^13.0.0",
+    "zod": "^3.25.76"
+  }
+}