README.md•2.67 kB
# OTP-MCP-Server
[](https://github.com/andreax79/otp-mcp/actions)
[](https://badge.fury.io/py/otp-mcp-server)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
[](https://pycqa.github.io/isort/)
<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 |