Feature: Complete BAR Tools Implementation[DO NOT MERGE]

README.md

@@ -54,6 +54,8 @@ We are providing groupings of tools and associated helpful prompts to support al
 - **DBA** tools, prompts and resources to facilitate your platform administration tasks:
   - [DBA Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/dba/README.md)
   - [Security Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/sec/README.md)
+- **BAR** tools, prompts and resources for database backup and restore operations:
+  - [BAR Tools](src/teradata_mcp_server/tools/bar/README.md) integrate AI agents with Teradata DSA (Data Stream Architecture) for comprehensive backup management across multiple storage solutions including disk files, cloud storage (AWS S3, Azure Blob, Google Cloud), and enterprise systems (NetBackup, IBM Spectrum).
 
 ## Quick start with Claude Desktop (no installation)
 > Prefer to use other tools? Check out our Quick Starts for [VS Code/Copilot](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_VSCODE.md), [Open WebUI](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_OPEN_WEBUI.md), or dive into [simple code examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/README.md#client-applications)!

pyproject.toml

@@ -29,6 +29,7 @@ dependencies = [
     "python-dotenv>=1.0.0",
     "PyYAML>=6.0.0",
     "sqlalchemy>=2.0.0,<3.0.0",
+    "requests>=2.25.0",
 ]
 
 [project.optional-dependencies]

src/teradata_mcp_server/app.py

@@ -243,6 +243,7 @@ def _exec(*args, **kwargs):
 
         _exec.__name__ = getattr(func, "__name__", "wrapped_tool")
         _exec.__signature__ = new_sig
+        _exec.__doc__ = func.__doc__  # Copy docstring from original function
         if annotations:
             _exec.__annotations__ = annotations
         return _exec

src/teradata_mcp_server/config/profiles.yml

@@ -39,4 +39,14 @@ eda:
   tool:
     - "base_(?!(writeQuery|dynamicQuery)$).*"
     - qlty_.*
-    - sec_userDbPermissions
+    - sec_userDbPermissions
+
+bar:
+  tool:
+    - ^bar_*
+    - ^base_readQuery$
+    - ^base_databaseList$
+  prompt:
+    - ^bar_*
+  resource:
+    - ^bar_*

src/teradata_mcp_server/tools/bar/README.md

@@ -0,0 +1,155 @@
+# BAR (Backup and Restore) Tools
+
+## AI Agent Integration with DSA Architecture
+
+```mermaid
+flowchart TD
+    %% AI Agent Layer
+    User[👤 User] --> LLM[🤖 AI Agent] --> Output[📄 Output]
+
+    %% MCP Integration
+    LLM --> MCP[🔌 MCP Server]
+    MCP --> API[🌐 DSA API]
+    API --> DSC[🎛️ DSC]
+
+    %% DSA Infrastructure
+    DSC --> DSMain[📊 DSMain]
+    DSC --> BarNC[📦 BarNC]
+
+    %% Data Flow
+    DB[(🗄️ Database)] <--> DSMain
+    DSMain <--> BarNC
+    BarNC --> Storage{💾 Storage}
+
+    %% Storage Options
+    Storage --> Disk[📁 Disk]
+    Storage --> Cloud[☁️ Cloud]
+    Storage --> Enterprise[🔒 Enterprise]
+
+    %% Styling
+    classDef primary fill:#e3f2fd,stroke:#1976d2
+    classDef secondary fill:#f3e5f5,stroke:#7b1fa2
+    classDef storage fill:#e8f5e8,stroke:#388e3c
+
+    class User,LLM,Output primary
+    class MCP,API,DSC secondary
+    class DSMain,BarNC,DB,Storage,Disk,Cloud,Enterprise storage
+```
+
+## Prerequisites
+
+**DSA Infrastructure** must be properly configured and running before using BAR tools
+
+### Environment Variables
+The BAR tools require the following environment variables for DSA connection:
+
+- `DSA_BASE_URL` - Base URL for DSA API (default: https://localhost:9090/)
+- `DSA_USERNAME` - Username for DSA authentication (default: admin)
+- `DSA_PASSWORD` - Password for DSA authentication (default: admin)
+- `DSA_VERIFY_SSL` - Whether to verify SSL certificates (default: true)
+- `DSA_CONNECTION_TIMEOUT` - Request timeout in seconds (default: 30)
+
+### BAR Profile Configuration
+The BAR profile is defined in `config/profiles.yml` and controls access to BAR-related tools and resources.
+
+**Profile Configuration:**
+```yaml
+bar:
+  tool:
+    - ^bar_*          # All BAR tools (bar_manageDsaDiskFileSystem, etc.)
+    - ^base_readQuery$  # Read-only database queries
+    - ^base_databaseList$  # Database listing
+  prompt:
+    - ^bar_*          # BAR-specific prompts
+  resource:
+    - ^bar_*          # BAR-specific resources
+```
+
+**What the BAR profile enables:**
+- Access to all `bar_*` tools for backup and restore operations
+- Basic database read operations for backup source identification
+- Database listing capabilities for backup planning
+- BAR-specific prompts and resources
+
+**Usage:** Specify `--profile bar` when running MCP server to enable BAR-specific functionality.
+
+
+## Available Tools
+
+**Total Estimated Tools: 16** (5 ✅ Developed, 11 🚧 Planned)
+
+### Storage Configuration Tools
+
+#### bar_manageDsaDiskFileSystem ✅
+**Status**: Developed
+Unified tool for managing DSA disk file system configurations for backup storage.
+
+#### bar_manageAwsS3 🚧 
+**Status**: Work-In-Progress
+Tool for managing AWS S3 bucket configurations for backup storage.
+
+#### bar_manageAzureBlob 🚧
+**Status**: Planned
+Tool for managing Azure Blob Storage configurations for backup storage.
+
+#### bar_manageGoogleCloud 🚧
+**Status**: Planned
+Tool for managing Google Cloud Storage configurations for backup storage.
+
+#### bar_manageNetBackup 🚧
+**Status**: Planned
+Tool for managing NetBackup configurations for enterprise backup storage.
+
+#### bar_manageIbmSpectrum 🚧
+**Status**: Planned
+Tool for managing IBM Spectrum Protect configurations for backup storage.
+
+### Infrastructure Management Tools
+
+#### bar_manageMediaServer ✅
+**Status**: Implemented
+Tool for managing media server configurations including list, get, add, delete, and consumer management operations.
+
+#### bar_manageTeradataSystem ✅
+**Status**: Implemented
+Tool for managing Teradata system configurations and consumers in DSA. Supports listing systems, getting system details, configuring new systems, enabling/deleting systems, and managing system consumers.
+
+### Target Group Management Tools
+
+#### bar_manageDiskFileTargetGroup ✅
+**Status**: Implemented
+Tool for managing disk file target group configurations with comprehensive management of backup target groups including create, list, get, enable, disable, and delete operations.
+
+#### bar_manageAwsS3TargetGroup 🚧
+**Status**: Planned
+Tool for managing media server configurations with AWS S3 storage solutions.
+
+#### bar_manageAzureBlobTargetGroup 🚧
+**Status**: Planned
+Tool for managing media server configurations with Azure Blob storage solutions.
+
+#### bar_manageGoogleCloudTargetGroup 🚧
+**Status**: Planned
+Tool for managing media server configurations with Google Cloud storage solutions.
+
+#### bar_manageNetBackupTargetGroup 🚧
+**Status**: Planned
+Tool for managing media server configurations with NetBackup storage solutions.
+
+#### bar_manageIbmSpectrumTargetGroup 🚧
+**Status**: Planned
+Tool for managing media server configurations with IBM Spectrum storage solutions.
+
+### Operations Management Tools
+
+#### bar_manageJob ✅
+**Status**: Implemented
+Comprehensive tool for managing backup and restore job lifecycle including creation, updates, retrieval, retirement, deletion, execution, and status monitoring. Supports all DSA job operations through REST API endpoints.
+
+#### bar_manageSaveSets 🚧
+**Status**: Planned
+Tool for managing backup files/objects (save sets) created by backup operations.
+
+---
+
+[← Return to Main README](../../../../README.md)

src/teradata_mcp_server/tools/bar/__init__.py

@@ -0,0 +1,2 @@
+from .bar_resources import *
+from .bar_tools import *

src/teradata_mcp_server/tools/bar/bar_objects.yml

@@ -0,0 +1,9 @@
+# BAR (Backup and Restore) Objects Configuration
+# This file contains object definitions for BAR tools, prompts, and resources
+
+# Note: The main BAR tools are implemented in bar_tools.py as they require
+# complex HTTP API interactions with DSA systems that cannot be represented
+# as simple SQL queries.
+
+# Future BAR-related prompts and simple tools can be defined here
+# following the standard YAML object format.

src/teradata_mcp_server/tools/bar/bar_resources.py

@@ -0,0 +1,11 @@
+"""
+BAR (Backup and Restore) Resources for Teradata DSA MCP Server
+Provides resources and guidance for DSA backup operations
+"""
+
+import logging
+
+logger = logging.getLogger("teradata_mcp_server")
+
+# Resources will be added here in the future
+# For now, this module provides the basic structure