# OTP-MCP-Server

[![MCP Server](https://badge.mcpx.dev?type=server)](https://glama.ai/mcp/servers/andreax79/otp-mcp)
[![Build Status](https://github.com/andreax79/otp-mcp/workflows/Tests/badge.svg)](https://github.com/andreax79/otp-mcp/actions)
[![PyPI version](https://badge.fury.io/py/otp-mcp-server.svg)](https://badge.fury.io/py/otp-mcp-server)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
<a href="https://glama.ai/mcp/servers/@andreax79/otp-mcp">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@andreax79/otp-mcp/badge" alt="otp-mcp-server MCP server" />
</a>

Model Context Protocol (MCP) server that provides OTP (One-Time Password) generation

A Model Context Protocol (MCP) server built with FastMCP
that provides secure OTP (One-Time Password) generation.
Supports TOTP (Time-based) and HOTP (HMAC-based) algorithms
and multiple transport options including stdio, SSE, and HTTP Stream
for seamless integration with AI assistants and applications.

## Quick Start

### Installation

```bash
# Use uvx for isolated execution
uvx otp-mcp-server

# Or install from PyPI
pip install otp-mcp-server
```

### Basic Usage

```bash
# Run with STDIO (default, for Claude Desktop)
otp-mcp-server

# Run with HTTP Stream transport
otp-mcp-server --http-stream --host 127.0.0.1 --port 8000

# Run with SSE transport
otp-mcp-server --sse --host 127.0.0.1 --port 8000
```

### Using with Claude Desktop

Add to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "otp": {
      "command": "uvx",
      "args": ["otp-mcp-server"]
    }
  }
}
```

### Configuration

You can configure the server using command-line arguments or environment variables.

| Environment Variable      | Description                                  |
|---------------------------|----------------------------------------------|
| `OTP_MCP_SERVER_DB`       | Path to the tokens database file             |
| `OTP_MCP_SERVER_HOST`     | Host to bind the server to                   |
| `OTP_MCP_SERVER_PORT`     | Port to bind the server to                   |
| `OTP_MCP_SERVER_TRANSPORT`| Transport protocol to use                    |
| `OTP_MCP_SERVER_PATH`     | Path for HTTP transport                      |
| `OTP_MCP_SERVER_LOG_LEVEL`| Logging level                                |