OTP-MCP-Server

Build Status PyPI version Python 3.11+ License: MIT Code style: black Imports: isort

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

# Use uvx for isolated execution uvx otp-mcp-server # Or install from PyPI pip install otp-mcp-server

Basic Usage

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

{ "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