JSPM

  • Created
  • Published
  • Downloads 153
  • Score
    100M100P100Q74042F
  • License MIT

Cequence MCP CLI - Command-line tool for setting up Cequence MCP servers with AI clients

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cequenceai/mcp-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Cequence MCP CLI

    A command-line tool by Cequence Security for easily setting up Cequence MCP (Model Context Protocol) servers with AI clients like Cursor IDE, Claude AI, and Windsurf IDE.

    Features

    • 🚀 One-command setup for Cursor IDE, Claude AI, and Windsurf IDE
    • 🔐 Support for API key authentication
    • 🛠️ Cross-platform support (macOS, Windows, Linux)
    • ✨ Automatic configuration file management
    • 📝 Clear setup instructions and feedback
    • 🔒 Powered by Cequence's API security platform

    Installation

    You can run the CLI directly using npx without installing it globally:

    npx @cequenceai/mcp-cli@latest --help

    Or install it globally:

    npm install -g @cequenceai/mcp-cli

    Usage

    Setup with Cursor IDE

    npx @cequenceai/mcp-cli@latest cursor --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"

    With API key authentication:

    npx @cequenceai/mcp-cli@latest cursor --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"

    Setup with Claude AI

    npx @cequenceai/mcp-cli@latest claude --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"

    With API key authentication:

    npx @cequenceai/mcp-cli@latest claude --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"

    Setup with Windsurf IDE

    npx @cequenceai/mcp-cli@latest windsurf --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway"

    With API key authentication:

    npx @cequenceai/mcp-cli@latest windsurf --url "https://your-cequence-gateway.com/mcp" --name "Cequence API Gateway" --api-key "your-api-key"

    List configured servers

    npx @cequenceai/mcp-cli@latest list

    Command Options

    Common Options

    • --url, -u: Required - Cequence MCP server URL
    • --name, -n: Server name (defaults to "Cequence MCP Gateway")
    • --api-key, -k: API key for authentication (optional)

    Examples

    1. Basic setup for Cursor:

      npx cequence-mcp-cli@latest cursor -u "https://api.example.com/mcp" -n "Example API via Cequence"
    2. Setup with authentication:

      npx cequence-mcp-cli@latest cursor -u "https://api.example.com/mcp" -n "Example API via Cequence" -k "sk-1234567890"
    3. Setup for Claude AI:

      npx cequence-mcp-cli@latest claude -u "https://api.example.com/mcp" -n "Example API via Cequence"
    4. Setup for Windsurf IDE:

      npx cequence-mcp-cli@latest windsurf -u "https://api.example.com/mcp" -n "Example API via Cequence"

    Configuration Locations

    The CLI automatically detects your platform and configures the appropriate files:

    Cursor IDE

    • All platforms: ~/.cursor/mcp.json

    Claude AI

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/claude/claude_desktop_config.json

    Windsurf IDE

    • All platforms: ~/.windsurf/mcp.json

    Post-Setup Steps

    After configuring Cursor IDE:

    1. Restart Cursor IDE
    2. Open the command palette (Cmd/Ctrl + Shift + P)
    3. Look for MCP-related commands
    4. Your Cequence-secured APIs are now available as MCP tools

    After configuring Claude AI:

    1. Restart Claude AI application
    2. The Cequence MCP server should be available in your conversation
    3. Start using your secured APIs through Claude's interface

    After configuring Windsurf IDE:

    1. Restart Windsurf IDE
    2. Open the command palette (Cmd/Ctrl + Shift + P)
    3. Look for MCP-related commands
    4. Your Cequence-secured APIs are now available as MCP tools

    About Cequence Security

    Cequence Security protects APIs from attacks, abuse, and data theft. This CLI tool enables you to easily connect your Cequence-secured APIs to AI development environments, providing secure and monitored access to your API resources.

    Troubleshooting

    Common Issues

    1. Permission errors: Make sure you have write permissions to the configuration directories
    2. Invalid URL: Ensure your Cequence MCP server URL is accessible and uses HTTP/HTTPS
    3. Configuration not applied: Try restarting the AI client application

    Getting Help

    npx @cequenceai/mcp-cli@latest --help
    npx @cequenceai/mcp-cli@latest cursor --help
    npx @cequenceai/mcp-cli@latest claude --help
    npx @cequenceai/mcp-cli@latest windsurf --help

    Development

    To contribute to this CLI tool:

    1. Clone the repository
    2. Install dependencies: npm install
    3. Build: npm run build
    4. Test locally: npm run dev

    License

    MIT License - see LICENSE file for details.

    Support

    For support with Cequence products or this CLI tool, please visit Cequence Security Support or open an issue in this repository.