@compligent/csf-cli

@compligent/csf-cli

Compligent CSF MCP Client - Connect to NIST CSF 2.0 via Compligent Gateway

A streamlined NPX client for accessing NIST Cybersecurity Framework 2.0 tools through the Compligent platform. This client provides authenticated access to your hosted database with cross-framework mappings and unified compliance tools.

🚀 Quick Start

Authentication

# Authenticate with Compligent Gateway via GitHub OAuth
npx @compligent/csf-cli auth

Claude Desktop Setup

# Generate Claude Desktop configuration automatically
npx @compligent/csf-cli setup

CLI Usage

# List available CSF tools
npx @compligent/csf-cli tools list

# Call a specific CSF tool
npx @compligent/csf-cli tools call list_csf_functions

# Get help
npx @compligent/csf-cli --help

📋 Claude Desktop Integration

After running npx @compligent/csf-cli setup, add this to your Claude Desktop config:

Location: ~/.config/claude_desktop/config.json (macOS/Linux)

{
  "mcpServers": {
    "compligent-csf": {
      "command": "npx",
      "args": ["@compligent/csf-cli"]
    }
  }
}

Then restart Claude Desktop and ask:

• "List CSF functions"
• "Help me with cybersecurity framework implementation"
• "Show me zero trust examples from CSF"

🛠️ Available Commands

Authentication

• auth - Authenticate with GitHub OAuth
• logout - Clear authentication
• status - Show authentication and config status

Configuration

• config show - Display current configuration
• config reset - Reset to default settings
• config set-env <env> - Set environment (development/staging/production)

Tools

• tools list - List all available CSF tools
• tools call <tool> [params] - Call a specific tool
  • Use --json '{"param": "value"}' for JSON parameters
  • Or use param=value for simple parameters

Setup

• setup - Generate Claude Desktop configuration

🔧 CSF 2.0 Tools Available

Through the Compligent Gateway, you have access to 13+ CSF tools:

Core Functions

• list_csf_functions - List all 6 CSF functions
• get_csf_function - Get function details
• search_csf_categories - Search categories and subcategories

Implementation Guidance

• get_csf_implementation_guide - Implementation guidance by organization type
• get_csf_implementation_examples - Practical implementation examples
• get_csf_examples_by_topic - Examples by topic (zero trust, cloud, etc.)
• get_csf_industry_examples - Industry-specific examples

Framework Mapping

• map_csf_to_framework - Map to other frameworks (SP 800-53, ISO 27001, etc.)
• search_csf_implementation_examples - Advanced example search

Analytics

• get_csf_implementation_statistics - Coverage statistics
• get_csf_maturity_indicators - Maturity indicators
• find_similar_csf_examples - Find similar examples

🏗️ Architecture Benefits

For Your Organization

• ✅ Controlled Access: All requests route through your authenticated gateway
• ✅ Usage Analytics: Track tool usage across your organization
• ✅ Tier Management: Control feature access based on subscription levels
• ✅ Cross-Framework Integration: Access unified compliance database
• ✅ Premium Features: Exclusive access to integrated tools

For End Users

• ✅ Simple Installation: npx @compligent/csf-cli - no setup complexity
• ✅ Automatic Authentication: Seamless GitHub OAuth integration
• ✅ Unified Access: One client for all compliance frameworks
• ✅ Premium Tools: Cross-framework mappings and unified guidance

🔐 Authentication Flow

• Run npx @compligent/csf-cli auth
• Browser opens to GitHub OAuth
• Authorize Compligent application
• JWT token stored securely locally
• All subsequent requests use authenticated gateway

🌐 Environment Configuration

Development (Local Gateway)

npx @compligent/csf-cli config set-env development
# Uses: http://localhost:8787

Production (Default)

npx @compligent/csf-cli config set-env production
# Uses: https://compligent-gateway.workers.dev

Staging

npx @compligent/csf-cli config set-env staging
# Uses: https://staging-api.compligent.io

🎯 Example Usage

List All CSF Functions

npx @compligent/csf-cli tools call list_csf_functions

Get Implementation Examples for Zero Trust

npx @compligent/csf-cli tools call get_csf_examples_by_topic \
  --json '{"topic": "zero_trust", "max_examples": 5}'

Search for Cloud Security Examples

npx @compligent/csf-cli tools call search_csf_implementation_examples \
  --json '{"query": "cloud security", "max_results": 10}'

Map CSF to SP 800-53

npx @compligent/csf-cli tools call map_csf_to_framework \
  --json '{"target_framework": "SP 800-53", "function_id": "GV"}'

🎁 Premium Features

When using the Compligent Gateway, you get access to exclusive features:

• Cross-Framework Mappings: Real NIST-sourced mappings between CSF, SP 800-53, SP 800-171
• Unified Compliance Tools: Tools that work across multiple frameworks
• Implementation Intelligence: AI-powered recommendations and gap analysis
• Industry Benchmarking: Compare against industry peers
• Automated Assessments: Generate compliance reports automatically

🆘 Troubleshooting

Authentication Issues

# Clear authentication and retry
npx @compligent/csf-cli logout
npx @compligent/csf-cli auth

Configuration Issues

# Reset configuration
npx @compligent/csf-cli config reset
npx @compligent/csf-cli status

Verbose Mode

# Enable verbose output for debugging
npx @compligent/csf-cli --verbose tools list

Check Status

# View current authentication and config status
npx @compligent/csf-cli status

📞 Support

• Documentation: https://docs.compligent.io
• Support Email: [e-mail]
• GitHub Issues: https://github.com/compligent/csf-cli/issues
• Website: https://compligent.io

📄 License

MIT License - see LICENSE file for details.

🔗 Related

• @compligent/sp53-cli - SP 800-53 client
• @compligent/sp171-cli - SP 800-171 client
• Compligent Platform - Full compliance platform

Built with ❤️ by the Compligent Team

Transform your cybersecurity compliance with unified, intelligent tools.