Credential Manager

🔐 Servidor MCP Credential Manager

Um servidor MCP seguro para gerenciar credenciais de API localmente. Somente leitura por padrão com armazenamento simples em JSON.

✨ Recursos

• 🔒 Seguro por padrão - O modo somente leitura evita alterações acidentais
• 📁 Armazenamento simples - ~/.credential-manager-mcp/credentials.json
• 🔧 Configuração fácil - Script de shell interativo
• 🔄 Seguro para múltiplas instâncias - Sempre lê dados atualizados do disco
• 🎯 Exposição mínima - Mostra apenas dados essenciais

🚀 Início Rápido

1. Instalar e Configurar

# Install from PyPI
uvx credential-manager-mcp

Configuração comum (Claude Desktop):

{
  "mcpServers": {
    "credential-manager": {
      "command": "uvx",
      "args": ["credential-manager-mcp"],
      "env": {
        "CREDENTIAL_MANAGER_READ_ONLY": "false"
      }
    }
  }
}

Configuração de desenvolvimento (executar a partir do código-fonte):

{
  "mcpServers": {
    "credential-manager": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/credential-manager-mcp",
        "run", "credential-manager-mcp"
      ],
      "env": {
        "CREDENTIAL_MANAGER_READ_ONLY": "false"
      }
    }
  }
}

2. Adicionar Credenciais

# Interactive mode
./add-credential.sh

# Command line
./add-credential.sh "GitHub" "https://api.github.com" "ghp_token" "username" "2024-12-31T23:59:59"

🛠 Ferramentas Disponíveis

Modo Somente Leitura (Padrão):

• list_credentials() - Listar credenciais (id, nome do aplicativo apenas)
• get_credential_details(credential_id) - Obter detalhes completos

Modo Leitura e Escrita:

• add_credential(app, base_url, access_token, [user_name], [expires])
• update_credential(credential_id, [fields...])
• delete_credential(credential_id)

📋 Exemplos de Uso

# List all credentials
list_credentials()
# {"credentials": [{"id": "abc...", "app": "GitHub"}], "count": 1}

# Get credential details
get_credential_details("credential-id")

# Add new credential (write mode only)
add_credential("GitHub", "https://api.github.com", "ghp_token", "user", "2024-12-31T23:59:59")

⚙️ Configuração

Variáveis de Ambiente:

• CREDENTIAL_MANAGER_READ_ONLY - Defina como "false" para operações de escrita (padrão: "true")

Formato de Expiração:

• "2024-12-31T23:59:59" - Data e hora ISO
• "never" - Sem expiração

🔒 Segurança

• Somente leitura por padrão
• Armazenamento local apenas (~/.credential-manager-mcp/credentials.json)
• Bloqueio de arquivo para acesso concorrente seguro
• Exposição mínima de dados nas listagens

🧪 Desenvolvimento

git clone https://github.com/mclamee/credential-manager-mcp.git
cd credential-manager-mcp
uv sync --dev
uv run pytest test/ -v

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.