Skip to content

Latest commit

 

History

History
152 lines (112 loc) · 2.35 KB

README.md

File metadata and controls

152 lines (112 loc) · 2.35 KB

deepctl-cmd-mcp

Part of deepctl — Official Deepgram CLI

MCP proxy command for deepctl — connects to Deepgram's developer API

Installation

This package is included with deepctl and does not need to be installed separately.

Install deepctl

# Install with pip
pip install deepctl

# Or install with uv
uv tool install deepctl

# Or install with pipx
pipx install deepctl

# Or run without installing
uvx deepctl --help
pipx run deepctl --help

Commands

Command Entry Point
deepctl mcp deepctl_cmd_mcp.command:McpCommand

MCP Server Setup

The deepctl mcp command runs an MCP (Model Context Protocol) proxy that connects to Deepgram's developer API and exposes tools to AI code editors.

Prerequisites

# Login to Deepgram (stores credentials in system keyring)
deepctl login

# Or set the environment variable
export DEEPGRAM_API_KEY="your-api-key"

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "deepgram": {
      "type": "stdio",
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Or with an explicit API key:

{
  "mcpServers": {
    "deepgram": {
      "type": "stdio",
      "command": "uvx",
      "args": ["deepctl", "--api-key", "YOUR_KEY", "mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "deepgram": {
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "deepgram": {
      "command": "uvx",
      "args": ["deepctl", "mcp"]
    }
  }
}

Alternative: pipx

Replace uvx with pipx run in any of the above configurations:

{
  "command": "pipx",
  "args": ["run", "deepctl", "mcp"]
}

Alternative: Local development

If running from a local clone of the repository:

{
  "command": "uv",
  "args": ["run", "dg", "mcp"]
}

Transport modes

By default the MCP server uses stdio (for editor integration). You can also run it as an HTTP server:

# SSE transport
deepctl mcp --transport sse --port 8000

Dependencies

  • mcp>=1.0.0
  • rich>=13.9.4
  • click>=8.1.7
  • pydantic>=2.10.1
  • uvicorn>=0.30.0
  • starlette>=0.37.0

License

MIT — see LICENSE