Doppler MCP Server

Un servidor simplificat Model Context Protocol (MCP) per accedir en mode només lectura a la plataforma de gestió de secrets de Doppler.

Features

Aquest servidor MCP proporciona tres eines essencials per accedir als secrets de Doppler:

• doppler_list_projects - Llista tots els projectes de Doppler accessibles amb el teu token
• doppler_list_secrets - Llista tots els noms de secrets d'un projecte/configuració específic
• doppler_get_secret - Obté el valor d'un secret específic

Installation

npm install @lepion/mcp-server-doppler

Configuration

Configura les teves variables d'entorn:

# Required
DOPPLER_TOKEN=your_doppler_token  # Service token, personal token, or CLI token

# Optional
LOG_LEVEL=info                     # debug, info, warn, error (default: info)

Usage

With Claude Desktop

Afegeix a la configuració de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["@lepion/mcp-server-doppler"],
      "env": {
        "DOPPLER_TOKEN": "dp.st.your_service_token"
      }
    }
  }
}

Available Tools

1. doppler_list_projects

Llista tots els projectes de Doppler accessibles amb el token.

Parameters: None

Example:

// Response
[
  {
    "id": "proj_123",
    "slug": "my-project",
    "name": "My Project",
    "description": "Production application",
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
]

2. doppler_list_secrets

Llista tots els noms de secrets d'un projecte i configuració específics.

Parameters:

• project (string, required) - El nom del projecte Doppler
• config (string, required) - El nom de la configuració/entorn (p. ex., dev, staging, production)

Example:

// Request
{
  "project": "my-project",
  "config": "production"
}

// Response
["DATABASE_URL", "API_KEY", "REDIS_URL", "JWT_SECRET"]

3. doppler_get_secret

Obtén el valor d'un secret específic.

Parameters:

• project (string, required) - El nom del projecte Doppler
• config (string, required) - El nom de la configuració/entorn
• name (string, required) - El nom del secret a recuperar

Example:

// Request
{
  "project": "my-project",
  "config": "production",
  "name": "DATABASE_URL"
}

// Response
{
  "name": "DATABASE_URL",
  "value": {
    "raw": "postgres://user:pass@host:5432/db",
    "computed": "postgres://user:pass@host:5432/db"
  }
}

Security Best Practices

• Use Service Tokens: Utilitza sempre tokens de servei amb àmbits limitats en lloc de tokens personals per a ús en producció
• Limit Token Scope: Crea tokens amb accés només de lectura i limita'ls a projectes/configuracions específiques
• Rotate Tokens: Rota regularment els teus tokens de Doppler
• Never Commit Tokens: No commiteu mai tokens de Doppler al control de versió

Development

# Clone the repository
git clone https://github.com/kayaozkur/mcp-server-doppler.git
cd mcp-server-doppler

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

Requirements

• Node.js 18 o superior
• Compte Doppler vàlid i token d'API

License

MIT

Contributing

Les contribucions són benvingudes! Si us plau, no dubteu a enviar una Pull Request.