Metadata-Version: 2.4
Name: deepctl-cmd-mcp
Version: 0.1.12
Summary: MCP proxy command for deepctl — connects to Deepgram's developer API
Author-email: Deepgram <devrel@deepgram.com>
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: deepctl-core>=0.1.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: rich>=13.9.4
Requires-Dist: click>=8.1.7
Requires-Dist: pydantic>=2.10.1
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: starlette>=0.37.0
Provides-Extra: dev
Requires-Dist: pytest>=8.3.3; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
Requires-Dist: mypy>=1.13.0; extra == "dev"
Requires-Dist: ruff>=0.8.1; extra == "dev"

# deepctl-cmd-mcp

> Part of [deepctl](https://github.com/deepgram/cli) — 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

```bash
# 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

```bash
# 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`:

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

Or with an explicit API key:

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

### Cursor

Add to `.cursor/mcp.json`:

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

### Windsurf

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

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

### Alternative: pipx

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

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

### Alternative: Local development

If running from a local clone of the repository:

```json
{
  "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:

```bash
# 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](../../LICENSE)
